 |
|
| If you can't view the Datasheet, Please click here to try to view without PDF Reader . |
|
|
|
| If you can't view the Datasheet, Please click here to try to view without PDF Reader . |
|
|
| Datasheet File OCR Text: |
| User's Manual ID78K0S-QB Ver. 2.81 Integrated Debugger Operation Target Device 78K0S Series Document No. U17287EJ1V0UM00 (1st edition) Date Published September 2004 CP(K) (c) NEC Electronics Corporation 2004 Printed in Japan [MEMO] 2 User's Manual U17287EJ1V0UM Windows are either a registered trademark or a trademark of Microsoft Corporation in the United States and/or other countries. User's Manual U17287EJ1V0UM 3 * The information in this document is current as of September, 2004. The information is subject to change without notice. For actual design-in, refer to the latest publications of NEC Electronics data sheets or data books, etc., for the most up-to-date specifications of NEC Electronics products. Not all products and/or types are available in every country. Please check with an NEC Electronics sales representative for availability and additional information. * No part of this document may be copied or reproduced in any form or by any means without the prior written consent of NEC Electronics. NEC Electronics assumes no responsibility for any errors that may appear in this document. * NEC Electronics does not assume any liability for infringement of patents, copyrights or other intellectual property rights of third parties by or arising from the use of NEC Electronics products listed in this document or any other liability arising from the use of such products. No license, express, implied or otherwise, is granted under any patents, copyrights or other intellectual property rights of NEC Electronics or others. * Descriptions of circuits, software and other related information in this document are provided for illustrative purposes in semiconductor product operation and application examples. The incorporation of these circuits, software and information in the design of a customer's equipment shall be done under the full responsibility of the customer. NEC Electronics assumes no responsibility for any losses incurred by customers or third parties arising from the use of these circuits, software and information. * While NEC Electronics endeavors to enhance the quality, reliability and safety of NEC Electronics products, customers agree and acknowledge that the possibility of defects thereof cannot be eliminated entirely. To minimize risks of damage to property or injury (including death) to persons arising from defects in NEC Electronics products, customers must incorporate sufficient safety measures in their design, such as redundancy, fire-containment and anti-failure features. * NEC Electronics products are classified into the following three quality grades: "Standard", "Special" and "Specific". The "Specific" quality grade applies only to NEC Electronics products developed based on a customerdesignated "quality assurance program" for a specific application. The recommended applications of an NEC Electronics product depend on its quality grade, as indicated below. Customers must check the quality grade of each NEC Electronics product before using it in a particular application. "Standard": Computers, office equipment, communications equipment, test and measurement equipment, audio and visual equipment, home electronic appliances, machine tools, personal electronic equipment and industrial robots. "Special": Transportation equipment (automobiles, trains, ships, etc.), traffic control systems, anti-disaster systems, anti-crime systems, safety equipment and medical equipment (not specifically designed for life support). "Specific": Aircraft, aerospace equipment, submersible repeaters, nuclear reactor control systems, life support systems and medical equipment for life support, etc. The quality grade of NEC Electronics products is "Standard" unless otherwise expressly specified in NEC Electronics data sheets or data books, etc. If customers wish to use NEC Electronics products in applications not intended by NEC Electronics, they must contact an NEC Electronics sales representative in advance to determine NEC Electronics' willingness to support a given application. (Note) (1) "NEC Electronics" as used in this statement means NEC Electronics Corporation and also includes its majority-owned subsidiaries. (2) "NEC Electronics products" means any product developed or manufactured by or for NEC Electronics (as defined above). M8E 02. 11-1 4 User's Manual U17287EJ1V0UM Regional Information Some information contained in this document may vary from country to country. Before using any NEC Electronics product in your application, pIease contact the NEC Electronics office in your country to obtain a list of authorized representatives and distributors. They will verify: * * * * * Device availability Ordering information Product release schedule Availability of related technical literature Development environment specifications (for example, specifications for third-party tools and components, host computers, power plugs, AC supply voltages, and so forth) Network requirements * In addition, trademarks, registered trademarks, export restrictions, and other legal issues may also vary from country to country. [GLOBAL SUPPORT] http://www.necel.com/en/support/support.html NEC Electronics America, Inc. (U.S.) Santa Clara, California Tel: 408-588-6000 800-366-9782 NEC Electronics (Europe) GmbH Duesseldorf, Germany Tel: 0211-65030 * Sucursal en Espana NEC Electronics Hong Kong Ltd. Hong Kong Tel: 2886-9318 NEC Electronics Hong Kong Ltd. Seoul Branch Seoul, Korea Tel: 02-558-3737 Madrid, Spain Tel: 091-504 27 87 * Succursale Francaise Velizy-Villacoublay, France Tel: 01-30-67 58 00 * Filiale Italiana NEC Electronics Shanghai Ltd. Shanghai, P.R. China Tel: 021-5888-5400 Milano, Italy Tel: 02-66 75 41 * Branch The Netherlands NEC Electronics Taiwan Ltd. Taipei, Taiwan Tel: 02-2719-2377 Eindhoven, The Netherlands Tel: 040-244 58 45 * Tyskland Filial NEC Electronics Singapore Pte. Ltd. Novena Square, Singapore Tel: 6253-8311 Taeby, Sweden Tel: 08-63 80 820 * United Kingdom Branch Milton Keynes, UK Tel: 01908-691-133 J04.1 User's Manual U17287EJ1V0UM 5 [MEMO] 6 User's Manual U17287EJ1V0UM PREFACE Target Readers This manual is intended for user engineers who design and develop application systems of the 78K0S Series. Purpose This manual is intended for users to understand the functions of the ID78K0S-QB in the organization below. Organization This manual consists of the following chapters: * OVERVIEW * INSTALLATION * STARTING AND TERMINATING * ASSOCIATION WITH PM plus * DEBUG FUNCTION * WINDOW REFERENCE * COMMAND REFERENCE How to Use This Manual It is assumed that the readers of this manual have general knowledge of electrical engineering, logic circuits, microcontrollers, C language, and assemblers. To understand the functions of the 78K0 Series Refer to Hardware User's Manual for each product. To understand the instruction functions of the 78K0 Series Refer to 78K/0 Series Instructions User's Manual (U12326E). Conventions Data significance: Note: Caution: Remark: Numerical representation: Higher digits on the left and lower digits on the right Footnote for item marked with Note in the text Information requiring particular attention Supplementary information Binary ... XXXX or XXXXB Decimal ... XXXX Hexadecimal ... 0xXXXX Prefix indicating the power of 2 (address space, memory capacity): K (Kilo): G (Giga): 210 = 1024 230 = 10243 M (Mega): 220 = 10242 User's Manual U17287EJ1V0UM 7 Related Documents Refer to the documents listed below when using this manual. The related documents indicated in this publication may include preliminary versions. However, preliminary versions are not marked as such. Documents related to development tools (User's Manuals) Document Name QB-78K0SKX1MINI In-Circuit Emulator RA78K0S Assembler Package Ver. 1.40 or later Operation Assembly Language Structured Assembly Language CC78K0S C Compiler Package Ver. 1.50 or later Operation Language SM plus System Simulator Operation User Open Interface ID78K0S-QB Ver. 2.81 Integrated Debugger PM plus Ver.5.10 Operation Document No. U17307E U16656E U16657E U11623E U16654E U16655E U17246E U17247E This manual U16569E 8 User's Manual U17287EJ1V0UM CONTENTS CHAPTER 1 OVERVIEW ... 16 1.1 Features ... 17 1.2 System Configuration ... 18 1.3 Operating Environment ... 19 1.3.1 Hardware environment ... 19 1.3.2 Software environment ... 19 1.4 Cautions During Debugging ... 20 1.4.1 When performing source level debugging ... 20 CHAPTER 2 INSTALLATION ... 21 2.1 Installing ... 21 2.2 Uninstalling ... 21 CHAPTER 3 STARTING AND TERMINATING ... 22 3.1 Startup Option and Argument Specification ... 23 3.1.1 Specification method ... 23 3.1.2 Specification format and options ... 24 3.2 Starting ... 26 3.3 Terminating ... 28 3.4 Error Messages at Start up ... 29 CHAPTER 4 ASSOCIATION WITH PM plus ... 30 4.1 Setting Build Mode ... 31 4.2 Registering Debugger to PM plus Project ... 32 4.2.1 Selecting debugger ... 32 4.3 To Start ID78K0S-QB from PM plus ... 33 4.3.1 Restoring debugging environment ... 33 4.4 Auto Load ... 34 4.4.1 Auto load by correcting source code ... 34 4.4.2 Auto load by starting debugger ... 35 CHAPTER 5 DEBUG FUNCTION ... 36 5.1 Setting Debugging Environment ... 37 5.1.1 Setting operating environment ... 37 5.1.2 Setting option ... 37 5.2 Download Function, Upload Function ... 38 5.2.1 Download ... 38 5.2.2 Upload ... 38 5.3 Source Display, Disassemble Display Function ... 39 5.3.1 Source display ... 39 5.3.2 Disassemble display ... 39 5.3.3 Mixed display mode (Source Window) ... 40 5.3.4 Convert symbol (symbol to address) ... 41 5.4 Break Function ... 42 5.4.1 Break types ... 42 5.4.2 Breakpoint setting ... 43 5.4.3 Setting breaks to variables ... 44 5.4.4 Hardware break and software break ... 45 5.5 Program Execution Function ... 46 5.6 Watch Function ... 48 5.6.1 Displaying and changing data values ... 48 5.6.2 Displaying and changing local variable values ... 49 5.6.3 Registering and deleting watch data ... 49 5.6.4 Changing watch data ... 50 5.6.5 Temporarily displaying and changing data values ... 50 5.6.6 Callout watch function ... 51 5.6.7 Stack trace display function ... 51 User's Manual U17287EJ1V0UM 9 5.7 Memory Manipulation Function ... 52 5.7.1 Displaying and changing memory contents ... 52 5.7.2 Filling, copying, and comparing memory contents ... 52 5.8 Register Manipulation Function ... 53 5.8.1 Displaying and changing register contents ... 53 5.8.2 Displaying and changing SFR contents ... 54 5.8.3 Displaying and changing I/O port contents ... 55 5.9 Event Function ... 56 5.9.1 Using event function ... 56 5.9.2 Creating events ... 56 5.9.3 Setting various event conditions ... 57 5.9.4 Number of enabled events for each event condition ... 58 5.9.5 Managing events ... 59 5.10 Real-time Monitor Function ... 60 5.10.1 Sampling range setting ... 60 5.10.2 Sampling time setting ... 60 5.11 Load/Save Function ... 61 5.11.1 Debugging environment (project file) ... 61 5.11.2 Window display information (view file) ... 63 5.11.3 Window setting information (setting file) ... 64 5.12 Functions Common to Each Window ... 65 5.12.1 Active status and static status ... 65 5.12.2 Jump function ... 66 5.12.3 Drag & drop function ... 68 5.12.4 Cautions ... 70 CHAPTER 6 WINDOW REFERENCE ... 71 6.1 Window List ... 72 6.2 Explanation of Windows ... 74 Main Window ... 75 Configuration Dialog Box ... 86 Extended Option Dialog Box ... 90 RRM Dialog Box ... 92 Debugger Option Dialog Box ... 95 Project File Save Dialog Box ... 101 Project File Load Dialog Box ... 103 Download Dialog Box ... 105 Upload Dialog Box ... 108 Source Window ... 110 Source Search Dialog Box ... 115 Source Text Move Dialog Box ... 117 Assemble Window ... 119 Assemble Search Dialog Box ... 123 Address Move Dialog Box ... 125 Symbol To Address Dialog Box ... 126 Watch Window ... 128 Quick Watch Dialog Box ... 133 Add Watch Dialog Box ... 136 Change Watch Dialog Box ... 139 Local Variable Window ... 141 Stack Window ... 143 Memory Window ... 146 Memory Search Dialog Box ... 149 Memory Fill Dialog Box ... 151 Memory Copy Dialog Box ... 153 Memory Compare Dialog Box ... 155 Memory Compare Result Dialog Box ... 157 Register Window ... 158 SFR Window ... 161 SFR Select Dialog Box ... 165 Add I/O Port Dialog Box ... 167 Software Break Manager ... 169 Event Manager ... 172 10 User's Manual U17287EJ1V0UM Event Dialog Box ... 177 Break Dialog Box ... 182 View File Save Dialog Box ... 184 View File Load Dialog Box ... 187 Environment Setting File Save Dialog Box ... 189 Environment Setting File Load Dialog Box ... 191 Reset Debugger Dialog Box ... 193 Exit Debugger Dialog Box ... 194 About Dialog Box ... 195 Console Window ... 197 Font Dialog Box ... 198 Browse Dialog Box ... 200 CHAPTER 7 COMMAND REFERENCE ... 202 7.1 Command Line Rules ... 203 7.2 Command List ... 204 7.3 List of Variables ... 205 7.4 List of Packages ... 206 7.5 Key Bind ... 206 7.6 Expansion Window ... 206 7.7 Callback Procedure ... 207 7.8 Hook Procedure ... 208 7.9 Related Files ... 209 7.10 Cautions ... 209 7.11 Command Name ... 209 address ... 210 assemble ... 211 batch ... 212 breakpoint ... 213 dbgexit ... 215 download ... 216 extwin ... 217 finish ... 218 go ... 219 help ... 220 hook ... 221 inspect ... 222 jump ... 223 map ... 224 mdi ... 225 memory ... 226 module ... 227 next ... 228 refresh ... 229 register ... 230 reset ... 231 run ... 232 step ... 233 stop ... 234 upload ... 235 version ... 236 watch ... 237 where ... 238 wish ... 239 7.12 Samples (Calculator Script) ... 240 APPENDIX A EXPANSION WINDOW ... 241 A.1 Overview ... 241 A.2 Sample List of Expansion Window ... 241 A.3 Activation ... 241 A.4 Explanation of Each Sample Window ... 241 List Window ... 242 Grep Window ... 243 User's Manual U17287EJ1V0UM 11 Hook Window ... 244 APPENDIX B INPUT CONVENTIONS ... 246 B.1 Usable Character Set ... 246 B.2 Symbols ... 247 B.3 Numeric Values ... 248 B.4 Expressions and Operators ... 248 B.5 File Names ... 251 APPENDIX C KEY FUNCTION LIST ... 252 APPENDIX D MESSAGES ... 255 D.1 Display Format ... 255 D.2 Types of Messages ... 255 D.3 Message Lists ... 256 APPENDIX E INDEX ... 274 12 User's Manual U17287EJ1V0UM LIST OF FIGURES Figure No 1-1 1-2 3-1 3-2 3-3 3-4 5-1 5-2 5-3 5-4 5-5 5-6 5-7 5-8 5-9 5-10 5-11 5-12 5-13 5-14 5-15 5-16 5-17 5-18 5-19 5-20 6-1 6-2 6-3 6-4 6-5 6-6 6-7 6-8 6-9 6-10 6-11 6-12 6-13 6-14 6-15 6-16 6-17 6-18 6-19 6-20 6-21 6-22 6-23 6-24 6-25 6-26 6-27 6-28 6-29 Title, Page ID78K0S-QB ... 16 Example of ID78K0S-QB System Configuration ... 18 Startup Option (Example) ... 23 Configuration Dialog Box ... 26 Main Window (at Startup) ... 27 Exit Debugger Dialog Box ... 28 Breakpoint Setting ... 43 Setting Break to Variable ... 44 Management of Software Breaks ... 45 Execution Button ... 46 [Run] Menu ... 46 Watch Window ... 48 Specification of the Display Format (Debugger Option Dialog Box) ... 48 Local Variable Window ... 49 Change Watch Dialog Box ... 50 Quick Watch Dialog Box ... 50 Stack Window ... 51 Displaying and Changing Memory Contents ... 52 Absolute Name/Function Name Switching ... 53 Displaying SFR Contents ... 54 Register I/O Port ... 55 Setting of Various Event Conditions ... 57 Managing Events (Event Manager) ... 59 Sampling Range Setting (RRM Dialog Box) ... 60 Sampling Time Setting ... 60 Automatic Save/Automatic Load Setting for Project File ... 61 Main Window ... 75 Toolbar (Picture Only) ... 83 Toolbar (Picture and Text) ... 83 Status Bar ... 84 Configuration Dialog Box ... 86 Extended Option Dialog Box ... 90 RRM Dialog Box ... 92 Debugger Option Dialog Box ... 95 Add Source Path Dialog Box ... 96 Project File Save Dialog Box ... 101 Project File Load Dialog Box ... 103 Download Dialog Box ... 105 The Progress of Download ... 105 Upload Dialog Box ... 108 Source Window ... 110 Source Search Dialog Box ... 115 Source Text Move Dialog Box ... 117 Assemble Window ... 119 Assemble Search Dialog Box ... 123 Address Move Dialog Box (Example: When Memory Window Is Open) ... 125 Symbol To Address Dialog Box ... 126 Watch Window ... 128 Quick Watch Dialog Box ... 133 Add Watch Dialog Box ... 136 Change Watch Dialog Box ... 139 Local Variable Window ... 141 Stack Window ... 143 Memory Window ... 146 Memory Search Dialog Box ... 149 User's Manual U17287EJ1V0UM 13 6-30 6-31 6-32 6-33 6-34 6-35 6-36 6-37 6-38 6-39 6-40 6-41 6-42 6-43 6-44 6-45 6-46 6-47 6-48 6-49 6-50 6-51 6-52 7-1 A-1 A-2 A-3 D-1 Memory Fill Dialog Box ... 151 Memory Copy Dialog Box ... 153 Memory Compare Dialog Box ... 155 Memory Compare Result Dialog Box ... 157 Register Window ... 158 SFR Window ... 161 SFR Select Dialog Box ... 165 Add I/O Port Dialog Box ... 167 Software Break Manager ... 169 Event Manager (In Detailed Display Mode) ... 172 Select Display Information Dialog Box ... 176 Event Dialog Box ... 177 Break Dialog Box ... 182 View File Save Dialog Box ... 184 View File Load Dialog Box ... 187 Environment Setting File Save Dialog Box ... 189 Environment Setting File Load Dialog Box ... 191 Reset Debugger Dialog Box ... 193 Exit Debugger Dialog Box ... 194 About Dialog Box ... 195 Console Window ... 197 Font Dialog Box ... 198 Browse Dialog Box ... 200 Execution Screen ... 240 List Window ... 242 Grep Window ... 243 Hook Window ... 244 Error/Warning Messages ... 255 14 User's Manual U17287EJ1V0UM LIST OF TABLES Table No 2-1 3-1 3-2 5-1 5-2 5-3 5-4 5-5 5-6 5-7 5-8 5-9 5-10 5-11 5-12 5-13 5-14 5-15 5-16 5-17 5-18 6-1 6-2 6-3 6-4 6-5 6-6 6-7 6-8 6-9 6-10 6-11 6-12 6-13 6-14 7-1 7-2 7-3 A-1 B-1 B-2 B-3 B-4 B-5 B-6 C-1 D-1 Title, Page Install ... 21 Startup Options ... 24 Execution File ... 25 Debug Function List (Flow of Debugging Operations) ... 36 Type of File That Can Be Downloaded ... 38 Type of File That Can Be Uploaded ... 38 File Type Can Be Displayed ... 39 Specifying Symbols ... 41 Break Types ... 42 The Number of Valid Software Break ... 45 Type of Execution ... 46 Absolute Name to Function Name Correspondence ... 53 Various Event Conditions ... 56 Number of Enabled Events for Each Event Condition ... 58 Event Icon ... 59 Contents Saved to Project File ... 62 Type of the View Files ... 63 Type of the Setting Files ... 64 Details of Jump Source Address ... 67 Details of Drag & Drop Function (Line/Address) ... 68 Details of Drag & Drop Function (Character String) ... 68 Window List ... 72 CPU Status ... 85 IE Status ... 85 Break Cause ... 85 Event Setting Status (Event Mark) ... 111 Watch Window Display Format (Symbol) ... 129 Watch Window Display Format (Data) ... 130 Watch Window Input Format ... 137 How a Variable Is Handled When a Scope Is Specified ... 137 Separator for Displaying Event Details ... 173 Status Condition ... 178 Settable Range of Address Condition (Event) ... 179 Settable Range of Data Condition ... 180 Number of Events Settable in Break Condition Setting Area ... 183 List of Debugger Control Commands ... 204 List of Console/Tcl Commands ... 205 Message ID ... 207 List of Expansion Window (Sample) ... 241 List of Character Set ... 246 List of Special Characters ... 246 Input Format of Numeric Values ... 248 List of Operators ... 249 Operator Priority ... 250 Range of Radixes ... 250 Key Function List ... 252 Types of Messages ... 255 User's Manual U17287EJ1V0UM 15 CHAPTER 1 OVERVIEW CHAPTER 1 OVERVIEW The Integrated Debugger ID78K0S-QB for the 78K0S Series (hereafter referred to as the ID78K0S-QB) is a software tool developed for NEC Electronics 78K0S Series of microcontrollers for embedded control. This software tool is intended to enable efficient debugging of user programs. Figure 1-1 ID78K0S-QB This chapter explains the following items regarding the ID78K0S-QB. - Features - System Configuration - Operating Environment - Cautions During Debugging 16 User's Manual U17287EJ1V0UM CHAPTER 1 OVERVIEW 1.1 Features The ID78K0S-QB has the following features: (1) Source debugging A C source program and source program in assembly language can be debugged. (2) Using function of in-circuit emulator By using the event setting function of an in-circuit emulator, break events can be set (refer to "5.9 Event Function"). (3) Automatic display updating function when execution is stopped If execution of the user program is stopped, the values of the window displayed on the screen are automatically updated. (4) Saving/restoring debugging environment The debugging environment including information on setting of breakpoints and events, downloading files, and display status and position of windows can be saved to a file (project file). By loading this project file, the debugging environment can be restored (refer to "5.11 Load/Save Function"). (5) Function expansion through Tcl The batch processing and hook processing, and the creation of original user custom windows are possible using the command line with Tcl/Tk (Tool Command Language) (refer to "CHAPTER 7 COMMAND REFERENCE", "APPENDIX A EXPANSION WINDOW"). User's Manual U17287EJ1V0UM 17 CHAPTER 1 OVERVIEW 1.2 System Configuration The ID78K0S-QB provides optimal debugging environments based on the following system configuration for user programs and target systems that were developed for the 78K0S Series. (1) QB-78K0SKX1MINI (In-circuit emulator) The QB-78K0SKX1MINI can be manipulated from the ID78K0S-QB by connecting it to the host machine via a USB cable. Figure 1-2 Example of ID78K0S-QB System Configuration Host machine QB-78K0SKX1MINI Target system USB 1.1/2.0 18 User's Manual U17287EJ1V0UM CHAPTER 1 OVERVIEW 1.3 Operating Environment This section explains the following items regarding the operating environment. - Hardware environment - Software environment 1.3.1 Hardware environment (1) Host machine The machine by which the target OS operates (2) In-circuit emulator QB-78K0SKX1MINI (QB-78K0SMINI + QB-78K0SKX1-DA) 1.3.2 Software environment (1) OS (any of the following) Windows98, Windows2000, WindowsMe, WindowsXP Home Edition, WindowsXP Professional Caution Regardless of which of the OS above is used, we recommend that the latest Service Pack is installed. (2) Device file (Individual acquisition) The device file of the target device to be used. This file is available from the following Web site of NEC Electronics. http://www.necel.com/micro/index_e.html User's Manual U17287EJ1V0UM 19 CHAPTER 1 OVERVIEW 1.4 Cautions During Debugging The cautions to be observed during debugging are described below. - When performing source level debugging 1.4.1 When performing source level debugging The object file for which source level debugging is performed must include symbol information or other information for debugging (debugging information). Therefore, perform the following processing during source file compiling. (1) When using PM plus Specify [Debug Build] when the Build mode is selected. (2) When using LK78K0S on standalone basis Add the -g option. 20 User's Manual U17287EJ1V0UM CHAPTER 2 INSTALLATION CHAPTER 2 INSTALLATION This chapter explains the following items about installation of ID78K0S-QB: - Installing - Uninstalling 2.1 Installing The following items must be installed, when the ID78K0S-QB is used. Table 2-1 Install Item ID78K0S-QB system disk Used device file Procedure Install the contents of this disk according to the automatically executed installer. Install this file according to the DFINST.exe dedicated startup installer by selecting [Start] menu -> [Program] -> [NEC Tools32] -> [Device File Installer]. Caution To install the ID78K0S-QB again after the ID78K0S-QB has been installed once, be sure to uninstall the ID78K0S-QB. If the ID78K0S-QB is installed in a directory different from that, without uninstalling, the ID78K0S-QB that has already been installed cannot be uninstalled. 2.2 Uninstalling Perform uninstallation using [Add/Remove Programs] on the Control Panel. User's Manual U17287EJ1V0UM 21 CHAPTER 3 STARTING AND TERMINATING CHAPTER 3 STARTING AND TERMINATING This chapter explains the following items related to the starting and terminating the ID78K0S-QB: - Startup Option and Argument Specification - Starting - Terminating - Error Messages at Start up 22 User's Manual U17287EJ1V0UM CHAPTER 3 STARTING AND TERMINATING 3.1 Startup Option and Argument Specification The procedure for specifying the startup options and arguments for the ID78K0S-QB is described below. By specifying the startup options and arguments, it is possible to specify the script file at startup and the project file. Remark When starting up the ID78K0S-QB from PM plus, the startup option and argument settings are performed in [Debugger Settings...] in the [Tool] menu of PM plus (refer to "CHAPTER 4 ASSOCIATION WITH PM plus"). The debugger startup option can be set to the option column. 3.1.1 1) Specification method Create an ID78K0S-QB shortcut on the desktop. The ID78K0S-QB execution file (*.exe) is located in the bin folder in the folder to which the installation was performed (refer to "Table 3-2 Execution File"). 2) Open the properties of the created shortcut and after the execution file name displayed in [Target:], specify the option and argument (refer to "3.1.2 Specification format and options"). Figure 3-1 Startup Option (Example) User's Manual U17287EJ1V0UM 23 CHAPTER 3 STARTING AND TERMINATING 3.1.2 Specification format and options (1) Specification format idk0s32o.exe ?options? idk0s32o.exe ?options? project Each option and argument is separated by a space. No distinction is made between uppercase and lowercase in the character string. Arguments enclosed between '?' can be omitted. When a project file is specified, that project file is read at startup. However, during PM plus startup, the project file specification is ignored. When there are spaces in the file names and paths, specify the project file names and script file names enclosed in double quotation marks (" "). (Refer to " Example 3) Specification when there are spaces in the path".) (2) Specification options The following options can be specified. Table 3-1 Startup Options Options /SC /SCRIPT:script file name Meaning Change background color of window to system color. Specify the script file to be executed at startup. (3) Specification example Example 1) Specification of script file only idk0s32o.exe /script:c:/work/script.tcl Example 2) Specification of script file and project file idk0s32o.exe /script:c:/work/script.tcl c:/work/project.prj Example 3) Specification when there are spaces in the path idk0s32o.exe /script:"c:/work folder/script.tcl" "c:/work folder/project.prj" Caution Make the script file (*.tcl file) name excluding the extension different from the load module file name and project file name. In the case of this example, do not place a file named project.tcl in c:/work ( or c:/work folder). 24 User's Manual U17287EJ1V0UM CHAPTER 3 STARTING AND TERMINATING (4) Execution file Execution files and names displayed from the [Start] menu are as follows. Table 3-2 Execution File Connected IE QB-78K0SKX1MINI Execution file idk0s32o.exe Name ([Start] Menu) ID78K0S-QB for MINICUBE User's Manual U17287EJ1V0UM 25 CHAPTER 3 STARTING AND TERMINATING 3.2 1) Starting Start ID78K0S-QB from the [Start] menu of PM plus or by clicking the shortcut created on the desktop. Refer to "4.3 To Start ID78K0S-QB from PM plus" when starting from PM plus. Start the ID78K0S-QB, the Configuration Dialog Box will be opened. Caution In this case, the Configuration Dialog Box should not be displayed, but an error message should be displayed, please cope with it with reference to "3.4 Error Messages at Start up" . Figure 3-2 Configuration Dialog Box 2) Set the items related to the operating environment of the ID78K0S-QB in the Configuration Dialog Box. After setting each item, click the 26 User's Manual U17287EJ1V0UM CHAPTER 3 STARTING AND TERMINATING 3) The Main Window will be opened and the ID78K0S-QB can be operated. Mainly use this window for debugging. Figure 3-3 Main Window (at Startup) User's Manual U17287EJ1V0UM 27 CHAPTER 3 STARTING AND TERMINATING 3.3 1) Terminating Select [File] menu -> [Exit] on the Main Window. The following the Exit Debugger Dialog Box will be opened: (An execution stop confirmation message is displayed when stop operation is performed during program execution.) Figure 3-4 Exit Debugger Dialog Box 2) To save the current debugging environment to a project file, click the 28 User's Manual U17287EJ1V0UM CHAPTER 3 STARTING AND TERMINATING 3.4 Error Messages at Start up Error messages that may be output when ID78K0S-QB starts up are listed below (by order of occurrence). When these messages are output, refer to "APPENDIX D MESSAGES". F0100: Can not communicate with ICE. Please confirm the installation of the device driver for the PC interface board. F03a0: Target is not turned on. A0105: Failed in reading device file (d0xxx.78k). F0ca2: This device file does not include the on-chip debug information. F0ca3: Unsupported information is included in the on-chip debug information in the device file. A01a0: No response from the emulation CPU. Please confirm the signal of the CLOCK or RESET and so on. User's Manual U17287EJ1V0UM 29 CHAPTER 4 ASSOCIATION WITH PM plus CHAPTER 4 ASSOCIATION WITH PM plus The ID78K0S-QB can automatically perform a series of operations in development processes, such as creating source files -> compiling -> debugging -> correcting source files, in association with the PM plus. This chapter explains the following items related to association with the PM plus. For details of the PM plus functions, refer to the PM plus User's Manual. - Setting Build Mode - Registering Debugger to PM plus Project - To Start ID78K0S-QB from PM plus - Auto Load Caution If a load module file is created by using the Windows command prompt, the function to associate the ID78K0S-QB with the PM plus cannot be used. 30 User's Manual U17287EJ1V0UM CHAPTER 4 ASSOCIATION WITH PM plus 4.1 Setting Build Mode To debug the load module file created by the PM plus on the ID78K0S-QB at the source level, build to output symbol information for debugging must be performed to create a load module file. This setting can be performed by selecting [Debug Build] on the PM plus. User's Manual U17287EJ1V0UM 31 CHAPTER 4 ASSOCIATION WITH PM plus 4.2 plus. Registering Debugger to PM plus Project The debugger to be used or the load module files to be downloaded can be specified for each project in the PM 4.2.1 Selecting debugger The procedure for selecting the debugger is as follows: The ID78K0S-QB is registered as the debugger of the active project. The ID78K0S-QB icon is displayed on the tool bar of the PM plus. (1) Creating a new workspace 1) Select [File] menu -> [New Workspace...] on the PM plus. -> This opens the dialog box to create a new workspace using the wizard format. 2) Creating the necessary settings for the workspace with the wizard, the [Select Debugger] dialog box will be opened. Specify ID78K0S-QB in this dialog box. (Refer to "Table 3-2 Execution File".) For details of the setting, refer to the User's manual. (2) Using an existing workspace 1) Select [Tool] menu -> [Debugger Settings...] on the PM plus. -> The [Debugger Settings] dialog box will be opened. 2) Specify ID78K0S-QB and click the 32 User's Manual U17287EJ1V0UM CHAPTER 4 ASSOCIATION WITH PM plus 4.3 To Start ID78K0S-QB from PM plus The ID78K0S-QB can be started from the PM plus as follows: - Click the ID78K0S-QB starting button on the tool bar of the PM plus. - Select the [Build] menu -> [Debug] on the PM plus. - Select the [Build] menu -> [Build and Debug] on the PM plus. - Select the [Build] menu -> [Rebuild and Debug] on the PM plus. If the debugging environment of the ID78K0S-QB is saved to a project file currently being used by the PM plus, it will be started in the debugging environment saved in the project file. If the debugging environment of the ID78K0S-QB is not saved to a project file being used by the PM plus, the Configuration Dialog Box is opened. At this time, the device type (chip name) cannot be changed. 4.3.1 Restoring debugging environment The previous debugging environment can be restored by the following procedure when the ID78K0S-QB is started from the PM plus: 1) 2) Create a new workspace (project file: e.g., sample.prj) on the PM plusNote. Start the ID78K0S-QB from the PM plus. Because a new project file is created, set items other than the device type (chip name) in the Configuration Dialog Box in the same manner as when only the ID78K0S-QB is started. 3) 4) 5) Download the load module file to be debugged with the Download Dialog Box of the ID78K0S-QB. Debug the load module file on the ID78K0S-QB. Click the User's Manual U17287EJ1V0UM 33 CHAPTER 4 ASSOCIATION WITH PM plus 4.4 Auto Load If a bug is found while the load module file is being debugged by the ID78K0S-QB, correct the source file using the following procedure. Compiling and re-downloading the file can be automatically executed. (Refer to "4.4.1 Auto load by correcting source code".) The load module is downloaded again to the ID78K0S-QB by compiling and linking the file on the PM plus with the activated ID78K0S-QB. (Refer to "4.4.2 Auto load by starting debugger".) Caution This processing cannot be performed if it is selected that the standard editor (idea-L) is used with the PM plus. 4.4.1 Auto load by correcting source code Correct the source file for auto load as follows: 1) Open the source file to be corrected in the Source Window. Select [File] menu -> [Open] and specify the file to be corrected on the ID78K0S-QB (if the file is already open in the Source Window, that window is displayed in the forefront). -> The specified file will be opened in the Source Window. 2) Select [Edit] menu -> [Edit Source] on the ID78K0S-QB. -> An editor will be opened and the specified source file will be read. 3) 4) Correct the source file on the editor. Terminate the editor. The CPU reset is not performed when the load module file is automatically downloaded. The debug window that was opened when the editor was called, and each event setting will be restored. If the previously used line or symbol has been deleted as a result of correcting the source file, the following happens: - A variable that was displayed is dimmed. - The event mark of an event condition is displayed in yellow. - A software break point may be deleted. 5) Select [Build] menu -> [Build and Debug], or [Build] menu -> [Rebuild and Debug] on the PM plus. Caution 34 User's Manual U17287EJ1V0UM CHAPTER 4 ASSOCIATION WITH PM plus 4.4.2 Auto load by starting debugger If the following operation is performed on the PM plus with the ID78K0S-QB started, the load module will be automatically downloaded to the ID78K0S-QB. - Selecting the [Build] menu -> [Build and Debug] on the PM plus. - Selecting the [Build] menu -> [Rebuild and Debug] on the PM plus. Remark Specify whether to use a CPU reset after downloading from [Debugger Settings...] on the [Tool] menu of PM plus (a CPU reset is performed by default). User's Manual U17287EJ1V0UM 35 CHAPTER 5 DEBUG FUNCTION CHAPTER 5 DEBUG FUNCTION This chapter explains about debug function of ID78K0S-QB. Table 5-1 Debug Function List (Flow of Debugging Operations) Item To set the debugging environment To download the load module To display the source file and the disassemble result To set a break point To execute the user program To check the variable value To check and edit the memory contents To check and change the register variable To manage the events RRM function To save the debug environment and window status Jump function and cautions Refer To 5.1 Setting Debugging Environment 5.2 Download Function, Upload Function 5.3 Source Display, Disassemble Display Function 5.4 Break Function 5.5 Program Execution Function 5.6 Watch Function 5.7 Memory Manipulation Function 5.8 Register Manipulation Function 5.9 Event Function 5.10 Real-time Monitor Function 5.11 Load/Save Function 5.12 Functions Common to Each Window 36 User's Manual U17287EJ1V0UM CHAPTER 5 DEBUG FUNCTION 5.1 Setting Debugging Environment This section explains the following items related to the setting debugging environment: - Setting operating environment - Setting option 5.1.1 Setting operating environment The in-circuit emulator operating environment settings are performed in the Configuration Dialog Box that is automatically displayed when ID78K0S-QB starts up. If a project file already exists, the debugging environment can be restored by clicking the 5.1.2 Setting option The extended options and debug options are set in the Extended Option Dialog Box, the Debugger Option Dialog Box . User's Manual U17287EJ1V0UM 37 CHAPTER 5 DEBUG FUNCTION 5.2 Download Function, Upload Function ID78K0S-QB allows downloading and uploading of object files in the formats listed in the following table: Table 52, Table 5-3. This section explains the following items: - Download - Upload 5.2.1 Download Object files are downloaded in the Download Dialog Box. The corresponding source text file (Source Window) is displayed by downloading load module files with debug information. Table 5-2 Type of File That Can Be Downloaded Format Load module (XCOFF(.LNK, .LMF)) Intel Hex format (00, 01, 02, 03 - 20 bit address) Motorola Hex format S type (S0, S2, S8) Extended Tektronix Hex format Binary data Binary Data (*.bin) Extension Load Module (*.lnk, *.lmf) Hex Format (*.hex)Note Note Automatic format detection 5.2.2 Upload Uploading of memory contents, etc., is performed in the Upload Dialog Box. The saving range can be set. Table 5-3 Type of File That Can Be Uploaded Format Intel Hex format (Standard - 16bit-address) Motorola Hex format S type (S0, S2, S8 - 24bit-address) Extended Tektronix Hex format Extension Hex Format (*.hex)Note Note Specify saving format 38 User's Manual U17287EJ1V0UM CHAPTER 5 DEBUG FUNCTION 5.3 Source Display, Disassemble Display Function Disassemble display and online assembly are per- Source file display is performed in the Source Window. formed in the Assemble Window. This section explains the following items: - Source display - Disassemble display - Mixed display mode (Source Window) - Convert symbol (symbol to address) 5.3.1 Source display The corresponding text file is displayed in the Source Window by downloading a load module file having debug information. The display start position can be changed in the Source Text Move Dialog Box displayed by selecting [View] menu -> [Move...]. Specifications related to the tab size, display font, etc., and specification of the source path are made in the Debugger Option Dialog Box. Specify a searching method in the Source Search Dialog Box opened by clicking the 5.3.2 Disassemble display Disassemble display is performed in the Assemble Window. The display start position can be changed in the Address Move Dialog Box opened by selecting [View] menu -> [Move...]. Offset display and register name display are specified in the Debugger Option Dialog Box. Specify a searching method in the Assemble Search Dialog Box opened by clicking the User's Manual U17287EJ1V0UM 39 CHAPTER 5 DEBUG FUNCTION 5.3.3 Mixed display mode (Source Window) Programs can be disassembled and displayed combined with the source file by selecting [View] menu -> [Mix] in the Source Window. The contents displayed in the mixed display mode can be saved as a view file. Normal display mode In the normal display mode, general text files can be displayed as well as source files. Mixed display mode If a program code corresponds to the line of the displayed source file, the disassembly line is displayed next to the source line. The label of the address, code data, and disassembled mnemonic are displayed (the display start position of the mnemonic is adjusted by the set value of the tab size). Caution The mixed display mode is valid only when the load module is downloaded and the symbol information is read, and the corresponding source file is displayed. 40 User's Manual U17287EJ1V0UM CHAPTER 5 DEBUG FUNCTION 5.3.4 Convert symbol (symbol to address) In the Symbol To Address Dialog Box, can be displayed the address of the specified variable or function, or the value of the specified symbol. Convert symbol is performed by selecting the character string to be converted in the Source Window or Assemble Window, and then selecting context menu -> [Symbol...]. The Specification symbols is indicated below. Table 5-5 Specifying Symbols Conversion Target Variable Specification Method var file#var (to specify a static variable with file name) func#var (to specify a static variable with function name) file#func#var (to specify a static variable with file name and function name) func file#func (to specify a static function with file name) label file#label (to specify a local label with file name) equsym file#equsym (to specify a local EQU symbol with file name) bitsym file#bitsym (to specify a local bit symbol with file name) file#no prog$file#no portname sfrname regname pswname Function Label EQU symbol Bit symbol Line number of source file I/O port name SFR name Register name PSW flag name Remark 1 Separator "#" "#" is used as a separator for file names, variables, function names, and line numbers. If a specified symbol is not found in the scope, all symbols (static variables, static functions, local labels) are searched. Remark 2 Separator "$" To specify a load module name when two or more load modules are read, use "$" as a separator to delimit the load module name from a file name, variable, function name, or symbol name. In the default status, a symbol name takes precedence. To temporarily change the priority, prefixing "$" to a symbol gives the priority to a register name. User's Manual U17287EJ1V0UM 41 CHAPTER 5 DEBUG FUNCTION 5.4 Break Function The break function is used to stop execution of the user program by the CPU. This section explains the following items: - Break types - Breakpoint setting - Setting breaks to variables - Hardware break and software break 5.4.1 Break types The ID78K0S-QB has the following break functions. Table 5-6 Break Types Item Hardware break Note1 (Event detection break) Software break Note1 Contents Function to stop user program execution upon detection of the set break event condition. -> Refer to "5.4.2 Breakpoint setting". Function to replace the instruction at the specified address software break instruction and stop the user program executed (refer to "5.4.4 Hardware break and software break"). -> Refer to "5.4.2 Breakpoint setting". Function to stop user program execution selected by selecting [Run] menu -> [Come Here] upon detection of address specified in the Source Window the Assemble Window. Function to stop execution upon satisfaction of the stop condition of each command ([Step In], [Next Over], [Return Out], [Slowmotion]). Function to forcibly stop execution by selecting [Run] menu > [Stop], or selecting the STOP button. It is valid for all the execution commands. [Come Here] break Note2 (Simple break) Break on satisfaction of condition of step execution Forced break Note1 Note2 This break is valid for [Go], [Go & GO], [Come Here] and [Restart]. After user program execution has been stopped, the breakpoint by this function is eliminated. During execution of a user program by this function, break events set before the cursor position does not occur. 42 User's Manual U17287EJ1V0UM CHAPTER 5 DEBUG FUNCTION 5.4.2 Window. Breakpoint setting Software breakpoints can simply be set to the desired location by clicking in the Source Window or the Assemble (1) Breakpoint setting method Breakpoints are executed by clicking lines in which " * " is displayed (lines where program code exists). Figure 5-1 Breakpoint Setting (2) Deleting a breakpoint method Click the position at which the breakpoint to be deleted is set. As a result of deletion, If another event remains, however, the mark of that event is displayed. User's Manual U17287EJ1V0UM 43 CHAPTER 5 DEBUG FUNCTION 5.4.3 Setting breaks to variables Access breaks can easily be set to variables from the context menu in the Source Window or the Watch Window. Figure 5-2 Setting Break to Variable 44 User's Manual U17287EJ1V0UM CHAPTER 5 DEBUG FUNCTION 5.4.4 Hardware break and software break (1) Hardware break Hardware breaks are breaks that are set using one hardware resource per event condition. Therefore, in the ID78K0S-QB, they are managed using "5.9 Event Function" as break event conditions. The number of valid break points varies depending on the device (refer to "5.9.4 Number of enabled events for each event condition"). Access events can only be set as hardware breaks in the ID78K0S-QB. (2) Software break Software breaks are breaks that are set by rewriting instructions of specified addresses to software break instructions. Therefore, the number of software breaks that can be set is not limited, but stopping at variable access timing, etc., cannot be specified. Table 5-7 The Number of Valid Software Break Product Name ID78K0S-QB 2000 Valid Number Software break is managed by the Software Break Manager. Figure 5-3 Management of Software Breaks User's Manual U17287EJ1V0UM 45 CHAPTER 5 DEBUG FUNCTION 5.5 Program Execution Function The program execution function is used to start execution of the user program by the CPU. Through user program execution, the program counter (PC) advances until the set breakpoint or forced break. (Refer to "5.4 Break Function".) The following types of ID78K0S-QB execution functions are provided. They are operated using the execution buttons on the tool bar , or from the [Run] menu. Figure 5-4 Execution Button Figure 5-5 [Run] Menu Table 5-8 Type of Execution Items [Restart] Contents The CPU is reset and the user program is executed starting from RESET address. This is the same operation as "resetting the CPU before execution of the user program and executing [Go]". The user program is executed starting from the address indicated by the current PC register and is stopped if a set break event condition is satisfied. The user program is executed starting from the address indicated by the current PC register Execution of the user program continues, ignoring set breakpoints. The user program is executed until execution returns to the calling function described in C language. In the Source Window, Step execution of one line of the source text is performed starting from the current PC register value and the contents of each window are updated. In the Assemble Window, One instruction is executed from the current PC register value and the contents of each window are updated. [Go] [Ignore break points and Go] [Return Out] [Step In] 46 User's Manual U17287EJ1V0UM CHAPTER 5 DEBUG FUNCTION Items [Next Over] Contents CALL / CALLT / CALLF instruction Next step execution is performed, assuming the function or subroutine called by the CALL / CALLT / CALLF instruction as one step (step execution continues until the nesting level becomes the same as when the CALL / CALLT / CALLF instruction was executed). Instruction other than CALL / CALLT / CALLF The same processing as [Step In] is performed. This command executes the user program starting from the specified address. Execution of the user program is stopped when a set break event condition is satisfied. The user program is executed from the address indicated by the current PC register to the address selected in the line/address display area of the Source Window or the Assemble Window, and then a break occurs. While the user program is being executed, the break event currently set does not occur. The user program is executed starting from the address indicated by the current PC register and stopped if a set break event condition is satisfied. The contents of each window are updated, and execution of the user program is resumed from the address at which the program was stopped. This operation is repeated until the user executes [Stop]. Step execution of one line is performed from the address indicated by the current PC register value in the source mode. In the instruction mode, step execution of one instruction is performed. The contents of each window are updated each time step execution is performed. This operation is repeated until the user executes [Stop]. [Start From Here] [Come Here] [Go & Go] [Slowmotion] User's Manual U17287EJ1V0UM 47 CHAPTER 5 DEBUG FUNCTION 5.6 Watch Function This section explains the following items related to the watch function: - Displaying and changing data values - Displaying and changing local variable values - Registering and deleting watch data - Changing watch data - Temporarily displaying and changing data values - Callout watch function - Stack trace display function 5.6.1 Displaying and changing data values Shifts in data values can be checked by Data values are displayed and changed in the Watch Window. registering watch data. The display format is specified in the Debugger Option Dialog Box. Figure 5-6 Watch Window Figure 5-7 Specification of the Display Format (Debugger Option Dialog Box) 48 User's Manual U17287EJ1V0UM CHAPTER 5 DEBUG FUNCTION 5.6.2 Displaying and changing local variable values Local variables are displayed and changed in the Local Variable Window. Local variables within the current function are automatically displayed in this window. (Variable addition/deletion is not possible.) Figure 5-8 Local Variable Window 5.6.3 Registering and deleting watch data Data can be registered to the Watch Window from the Source Window or the Assemble Window. This is simply done by selecting the variable or symbol name in the respective window, and then clicking the elements of an array, and members of structures and unions, cannot be deleted. User's Manual U17287EJ1V0UM 49 CHAPTER 5 DEBUG FUNCTION 5.6.4 Changing watch data Watch data is changed in the Change Watch Dialog Box. Note that the symbol name can be changed even if it results in duplication of a name already in use with existing data. Figure 5-9 Change Watch Dialog Box 5.6.5 Temporarily displaying and changing data values Data values are temporarily displayed and changed in the Quick Watch Dialog Box. Select the desired variable or symbol name in the Source Window or the Assemble Window and click the 50 User's Manual U17287EJ1V0UM CHAPTER 5 DEBUG FUNCTION 5.6.6 Callout watch function The corresponding variable value pops up when the mouse cursor is placed over a selected variable in the Source Window or the Assemble Window. 5.6.7 Stack trace display function This function displays the stack contents of the current user program in the Stack Window. Figure 5-11 Stack Window User's Manual U17287EJ1V0UM 51 CHAPTER 5 DEBUG FUNCTION 5.7 Memory Manipulation Function This section explains the following items related to the memory manipulation: Verify check, etc., is specified in the Extended Option Dialog Box. - Displaying and changing memory contents - Filling, copying, and comparing memory contents 5.7.1 Displaying and changing memory contents In the Memory Window, the memory contents can be displayed or changed by using mnemonic codes, hexadecimal codes, and ASCII codes. Searching is done in the Memory Search Dialog Box displayed by clicking the 5.7.2 Filling, copying, and comparing memory contents Memory contents are Filled, copied, and compared in the Memory Fill Dialog Box, the Memory Copy Dialog Box, and the Memory Compare Dialog Box displayed by selecting [Edit] menu -> [Memory] -> [Fill.../Copy.../Compare...]. The comparison results are displayed in the Memory Compare Result Dialog Box. 52 User's Manual U17287EJ1V0UM CHAPTER 5 DEBUG FUNCTION 5.8 Register Manipulation Function This section explains the following items related to the register manipulation function. - Displaying and changing register contents - Displaying and changing SFR contents - Displaying and changing I/O port contents 5.8.1 Displaying and changing register contents Register contents can be displayed and changed in the Register Window. Register name display switching (absolute name/function name) can be done in the Debugger Option Dialog Box. Figure 5-13 Absolute Name/Function Name Switching Table 5-9 Absolute Name to Function Name Correspondence Function Name Pair Register ax Register x a bc c b de e d hl l h rp3 rp2 rp1 Absolute Name Pair Register rp0 Register r0 r1 r2 r3 r4 r5 r6 r7 User's Manual U17287EJ1V0UM 53 CHAPTER 5 DEBUG FUNCTION 5.8.2 Displaying and changing SFR contents The SFR contents can be displayed and changed in the SFR Window. The display start position can be changed in the Address Move Dialog Box displayed by selecting [View] menu > [Move...]. The display register is selected in the SFR Select Dialog Box. Figure 5-14 Displaying SFR Contents 54 User's Manual U17287EJ1V0UM CHAPTER 5 DEBUG FUNCTION 5.8.3 Displaying and changing I/O port contents User-defined I/O ports can be displayed and changed in the SFR Window once they have been registered in the Add I/O Port Dialog Box. In the case of products that support programmable I/O registers, programmable I/O register contents can be displayed and changed by setting programmable I/O area use in the Configuration Dialog Box. Figure 5-15 Register I/O Port User's Manual U17287EJ1V0UM 55 CHAPTER 5 DEBUG FUNCTION 5.9 Event Function Events specify specific states of the target system during debugging ,such as "wrote data to address 0x2000". The ID78K0S-QB uses an event to trigger an action of functions such as break functions. This section explains the following items: - Using event function - Creating events - Setting various event conditions - Number of enabled events for each event condition - Managing events 5.9.1 Using event function Events (event conditions) are assigned various debugging functions and consist of the event conditions listed in the following table. Table 5-10 Various Event Conditions Contents ->Setting Dialog Box Condition in which the execution of the user program is stopped (refer to "5.4 Break Function"). -> Break Dialog Box Event Condition Break event condition Mark B 5.9.2 Creating events Events can be used as action triggers of various event conditions described before through registration of event conditions, by individually naming states called events. (1) Creating and registering events Event conditions are usually created in the Event Dialog Box. Set an address condition, status condition, and data condition in this dialog box. Specify a combination of these as one event condition and name and register this event condition. 56 User's Manual U17287EJ1V0UM CHAPTER 5 DEBUG FUNCTION 5.9.3 Setting various event conditions Various event conditions listed in Table 5-10 are individually created in the corresponding dialog box. (1) Setting of various event conditions The setting of the various event conditions is done by selecting the event icon of the desired event condition displayed in the event manager area (or Event Manager) in the respective setting dialog box, and dragging and dropping this icon in the condition area to be set. Figure 5-16 Setting of Various Event Conditions The shape of the mouse cursor changes to "OK" when it is dragged over a settable condition area. Regarding the created event conditions, the event icon mark becomes red and the setting is enabled by clicking User's Manual U17287EJ1V0UM 57 CHAPTER 5 DEBUG FUNCTION (4) Manipulation in event manager area Event conditions can be set by clicking the 5.9.4 Number of enabled events for each event condition Up to 256 conditions can be registered as event conditions or various event conditions. However, the number of event conditions that can be set (enabled) at the same time is limited as follows: Therefore, if the valid number is exceeded or if the used event conditions exceed the maximum number that can be used simultaneously, it is necessary to disable the set various event conditions once and then register them again. (Refer to "5.9.5 Managing events".) Table 5-11 Number of Enabled Events for Each Event Condition Event Connected IE Execute QB-78K0SKX1MINI 0 Access 1 Event Link - Break 1 Trace - Timer - 58 User's Manual U17287EJ1V0UM CHAPTER 5 DEBUG FUNCTION 5.9.5 Managing events Events are managed by the Event Manager. The Event Manager allows display, enabling/disabling, and deletion of the Various Event Conditions. Figure 5-17 Managing Events (Event Manager) (1) Event icons Event icons consist of a mark and an event name indicating the type of event. The color of each event icon indicates the setting status of that event. Enable/disable is switched by clicking the mark part. Table 5-12 Event Icon Character Color Red E. B. Black E. B. Yellow E. B. Mark Meaning Indicates that the event condition which is used for various event conditions is enabled. Indicates that the Various Event Conditions is enabled. The various events occurs when its condition is satisfied. Indicates that the event condition which is used for various event conditions is disabled. Indicates that the Various Event Conditions is disabled. The various events do not occur even when its condition is satisfied. Indicates that the symbol specified for an event is held pending because it cannot be recognized by the program currently loaded. Indicates that the Various Event Conditions is held pending. The various events do not occur even when its condition is satisfied. User's Manual U17287EJ1V0UM 59 CHAPTER 5 DEBUG FUNCTION 5.10 Real-time Monitor Function The real-time monitor function (RRM function) displays in real time the variables allocated to the sampling range, data, etc., in the Watch Window or the Memory Window. This section explains the following items: - Sampling range setting - Sampling time setting 5.10.1 Sampling range setting The sampling range for the RRM function is set in the RRM Dialog Box. Up to 8 locations can be set in 2-byte units in the 16 bytes RRM area. Figure 5-18 Sampling Range Setting (RRM Dialog Box) 5.10.2 Sampling time setting The sampling time for the RRM function is set in the Extended Option Dialog Box. Values are updated at the specified time interval. Figure 5-19 Sampling Time Setting 60 User's Manual U17287EJ1V0UM CHAPTER 5 DEBUG FUNCTION 5.11 Load/Save Function ID78K0S-QB allows saving and loading the following types of information as files. As a result, recovery of these various types of information is possible. Remark The simple window status can be maintained by selecting [Window] menu -> [Static]. (Refer to "5.12.1 Active status and static status".) This section explains the following items: - Debugging environment (project file) - Window display information (view file) - Window setting information (setting file) 5.11.1 Debugging environment (project file) A project file (*.prj) is a file that records the debugging environment. A project file is created when the debugging environment at a particular point in time is saved, and that debugging environment can be restored by loading this file at a subsequent time. Project files are loaded and saved in the Project File Save Dialog Box and the Project File Load Dialog Box, respectively. To load a project file at startup, press the User's Manual U17287EJ1V0UM 61 CHAPTER 5 DEBUG FUNCTION (2) Contents saved to project File The following contents are saved to the project file: Table 5-13 Contents Saved to Project File Window Name Configuration Dialog Box Main Window Download Dialog Box Extended Option Dialog Box Debugger Option Dialog Box Source Window Assemble Window Memory Window Stack Window SFR Window Local Variable Window Event Manager Console Window Expansion Window Event Dialog Box Break Dialog Box Register Window Watch Window Add I/O Port Dialog Box Software Break Manager Saved Contents All items (target device, clock setting, pin mask setting, mapping information) Display position, toolbar/status bar/button display information, execution mode information File information to be downloaded Set information Display information of window Display information of window, display start address Display information of window Display information of window, event information Display information of window, break event information Display information of window Display information of window, watch registration information Added I/O port information Display information of window, software break information 62 User's Manual U17287EJ1V0UM CHAPTER 5 DEBUG FUNCTION 5.11.2 Window display information (view file) A view file is a file that records window display information. View files can be loaded and saved for each window. When a view file is loaded, a reference window (Source Window in the static status) is displayed and the display information at the time of saving is displayed. View files are loaded and saved in the View File Load Dialog Box and the View File Save Dialog Box, respectively. Table 5-14 Type of the View Files Target Window File Name Source Window View file of the Source Window Assemble Window View file of the Assemble Window Memory Window View file of the Memory Window Watch Window View file of the Watch Window Register Window View file of the Register Window SFR Window View file of the SFR Window Local Variable Window View file of the Local Variable Window Stack Window View file of the Stack Window All files Source fileNote Text file File Type Source Text (*.svw) Assemble (*.dis) Memory (*.mem) Watch (*.wch) Register (*.rgw) SFR (*.sfr) Local Variable (*.loc) Stack Trace (*.stk) All (*.*) Source (*.c, *.s, *.asm) (During downloading) Text (*.txt) Note The extension of the source file can be changed in the Extended Option Dialog Box. User's Manual U17287EJ1V0UM 63 CHAPTER 5 DEBUG FUNCTION 5.11.3 settings). Window setting information (setting file) A setting file is a file that records the window setting information (watch data settings, SFR settings, and event Setting files can be loaded and saved for each window. When a setting file is loaded, the target window is displayed and the setting information that was saved is restored. Setting files are loaded and saved in the Environment Setting File Load Dialog Box and the Environment Setting File Save Dialog Box, respectively. Table 5-15 Type of the Setting Files Target Window File Name Watch Window Setting file of the Watch window SFR Window Setting file of the SFR window Event Manager Setting file of event File Type Watch (*.wch)Note SFR (*.sfr)Note Event (*.evn) Note A variable value can not be loaded. 64 User's Manual U17287EJ1V0UM CHAPTER 5 DEBUG FUNCTION 5.12 Functions Common to Each Window The windows have the following common functions. - Active status and static status - Jump function - Drag & drop function - Cautions 5.12.1 Active status and static status The Source Window that is displaying the source file to which symbol information is read, Assemble Window and Memory Window has two statuses: Only one window can be opened in the active status. However, because two or more windows in the static status can be opened, the current status of the windows can be temporarily held. Select this status by the [Window] menu. (1) Active status The display position and contents of the window in the active status are automatically updated in association with the current PC value. This window is also the jump destination of the Jump function. Only one window can be opened in the active status. (2) Static status The display position of the window in the static status does not move in association with the current PC value, but the displayed contents are updated. The static window is not used as the jump destination of the Jump function. If an active window is already open, the next window is opened in the static status. Two or more static windows can be opened at the same time. User's Manual U17287EJ1V0UM 65 CHAPTER 5 DEBUG FUNCTION 5.12.2 Jump function The jump function is used to jump to the Source Window, the Assemble Window or the Memory Window from a jump pointer that is the line or address on which the cursor is placed, and display the contents of the jump destination window from the jump pointer. You can jump among the above windows, or from the Stack Window, the Event Manager and the Register Window to the above windows. (1) Jump method The jump method is as follows: 1) Move the cursor to the line or address that is to be used as the jump pointer, on the window from which jumping is possible (select an event icon on the Event Manager). 2) Select the following menu item to which execution is to jump from the [Jump] menu. Source Window -> Select [Source Text] Assemble Window -> Select [Assemble] Memory Window -> Select [Memory] Caution If a program code does not exist on the line at the cursor position, the first address of the line with a program code above or below that line is used as the jump pointer. 66 User's Manual U17287EJ1V0UM CHAPTER 5 DEBUG FUNCTION (2) Details of jump source address The details of jump source address is as follows: Table 5-16 Details of Jump Source Address Target Window From the Register Window From the Memory Window From the Event Manager Registers selected Address at the cursor position Details of Jump Pointer If the selected event icon is that of an event condition, an address condition is used as the jump pointer. If the address condition is set in point If the address condition is set in range If the address condition is set in bit Jump to specified address Jump to lower address (point address before the mask if a mask is specified) Jump to address at the bit position From the Stack Window A function at the cursor position that stack flame number indicates is used as the jump pointer. With current function If the jump destination is the Source Window Other than above Jumps to the current PC line Jumps to the current PC address With function other than current function If the jump destination is the Source Window Other than above Jump to the Source Window or the Assemble Window Fetch address Jump to the line that calls a nested function. Jump to the address next to the instruction that calls a nested function. User's Manual U17287EJ1V0UM 67 CHAPTER 5 DEBUG FUNCTION 5.12.3 Drag & drop function Selected and highlighted line numbers, addresses, and text can be dragged and dropped in another window using the following method. 1) Drag the selected line number, address, or text. -> The shape of the mouse cursor changes from an arrow to "-". 2) Drop the selection in a window or area where it can be dropped. -> The shape of the cursor changes from "-" to "OK" when the cursor is placed over a window or area where the selection can be dropped. In the window in which the line number of the address has been dropped, an operation is performed on the dropped address or the address that is obtained from the dropped line number. For example, a variable can be simply registered by dragging and dropping in the Watch Window such a variable located in the Source Window. (1) Drag & drop details The operation to be performed after dropping the line number or address differs, depending on the window or area in which the line number or address has been dropped. Table 5-17 Details of Drag & Drop Function (Line/Address) Window/Area to Drop to Condition setting area in each various event setting dialog box (address and data setting areas) Operation After Drop The text of the dropped line number or address is set in the area in which the line number or address has been dropped. The address condition is set for the closest symbol in the format of symbol name + offset value. Table 5-18 Details of Drag & Drop Function (Character String) Window/Area to Drop to The Event Manager or the event manager area in each various event setting dialog box Operation After Drop If the dropped text can be converted as a symbol into an address value, an event condition in the Access status (all access statuses) or Execute status is automatically created, using the converted address value as an address condition. Event condition names are automatically created as Evt00001, Evt00002, and so on. A data condition and path count are not specified. The address condition is set by the dropped text. The relationship between the event condition to be created and the symbol is as follows: Symbols Variable Function Symbol in data section Symbol in code section Others Status Access (R/W) Execute Access (R/W) Execute Access (R/W) 68 User's Manual U17287EJ1V0UM CHAPTER 5 DEBUG FUNCTION Window/Area to Drop to Condition setting area in each various event setting dialog box (other than address and data setting areas) Operation After Drop If the dropped text can be converted as a symbol into an address value, an event condition in the Access status (all access statuses) or Execute status is automatically created, using the converted address value as an address condition. The automatically created event condition is set in each condition setting area in which the line number or address has been dropped. Event condition names are automatically created as Evt00001, Evt00002, and so on. A data condition and path count are not specified. The address condition is set by the dropped text. The relationship between the event condition to be created and the symbol is as follows: Symbols Variable Function Symbol in data section Symbol in code section Others Status Access (R/W) Execute Access (R/W) Execute Access (R/W) Condition setting area in each various event setting dialog box (address and data setting areas) Watch Window The dropped text is set in the area. If the dropped text is recognizable as a symbol, the contents of the symbol are displayed. Caution The various event setting dialog boxes include the Event Dialog Box and the Break Dialog Box. User's Manual U17287EJ1V0UM 69 CHAPTER 5 DEBUG FUNCTION 5.12.4 Cautions - The number of characters that can be displayed on 1 line in each area of a window is 319. - If the width of the display area is narrow, the display may become corrupted. In this case, increase the width of the window. - When scrolling is performed using the cursor keys in the Mixed display mode (Source Window), excessive scrolling may occur. Also, scrolling down to the last line may not be possible using the cursor keys. - If the screen resolution is low (800 - 600, etc.), all the statuses may not be displayed on the status bar. - Do not select [Slowmotion] from the [Run] menu during Go & Go execution. [Slowmotion] on the [Run] menu is usually dimmed during Go & Go execution, but there is a moment when it can be selected, so if [Slowmotion] is selected at this time, the program will not be able to be stopped even if [Stop] is selected from the [Run] menu (or the STOP button is clicked). - Memory Window When the display address is changed in the Memory Window, the position of the caret in the ASCII display area is not synchronized. - SFR select Dialog Box If the display arrangement is changed in the SFR select Dialog Box, multiple lines cannot be selected. Select one line at a time. - The number of lines displayed in the Watch Window A maximum of 10,000 lines can be displayed in the Watch Window. - The number of C and assembly language source file support lines Up to 65,535 lines of C and assembly language source files can be displayed. If the source files exceed 65,535 lines, partition them. - The switching of applications during dragging If for some reason or other the application switches while event icons are in the process of being dragged, the icons will no longer be able to be dropped. Use the ESC key to escape from drag, then reattempt the drag. 70 User's Manual U17287EJ1V0UM CHAPTER 6 WINDOW REFERENCE CHAPTER 6 WINDOW REFERENCE This chapter explains in detail the functions of the windows and dialog boxes of ID78K0S-QB. - Window List - Explanation of Windows User's Manual U17287EJ1V0UM 71 CHAPTER 6 WINDOW REFERENCE 6.1 Window List The list is the windows of the ID78K0S-QB. Table 6-1 Window List Window Name Main Window Contents This window is displayed first, when the ID78K0S-QB is started. It controls execution of the user program. Various windows are opened from this window. Displays and sets the ID78K0S-QB operation environment. Displays and sets the extended options of the ID78K0S-QB. Sets the RRM sampling range. Displays and sets other options. Saves the current debug environment to project file. Loads the debug environment. Loads an object file and binary file. Saves the memory contents to a file. Displays a source file and text file. Searches in the Source Window. Specifies a file to be displayed in the Source Window and the position from which displaying the file is to be started. Disassembles the program and executes online assembly. Searches in the Assemble Window. Specifies the start address to display the contents of the Memory Window or Assemble Window. Displays the address of the specified variable or function, or the value of the specified symbol. Displays and changes specified watch data. Displays temporarily specified watch data. Registers watch data todisplay in the Watch Window. Changes watch data todisplay in the Watch Window. Displays and changes the local variable in the current function. Displays the current stack contents. Displays the contents of memory. Searches in the Memory Window. Fills the memory contents with specified data. Copies the memory. Configuration Dialog Box Extended Option Dialog Box RRM Dialog Box Debugger Option Dialog Box Project File Save Dialog Box Project File Load Dialog Box Download Dialog Box Upload Dialog Box Source Window Source Search Dialog Box Source Text Move Dialog Box Assemble Window Assemble Search Dialog Box Address Move Dialog Box Symbol To Address Dialog Box Watch Window Quick Watch Dialog Box Add Watch Dialog Box Change Watch Dialog Box Local Variable Window Stack Window Memory Window Memory Search Dialog Box Memory Fill Dialog Box Memory Copy Dialog Box 72 User's Manual U17287EJ1V0UM CHAPTER 6 WINDOW REFERENCE Window Name Memory Compare Dialog Box Memory Compare Result Dialog Box Register Window SFR Window SFR Select Dialog Box Add I/O Port Dialog Box Event Manager Software Break Manager Event Dialog Box Break Dialog Box View File Save Dialog Box View File Load Dialog Box Environment Setting File Save Dialog Box Environment Setting File Load Dialog Box Reset Debugger Dialog Box Exit Debugger Dialog Box About Dialog Box Console Window Font Dialog Box Browse Dialog Box Compares the memory. Contents Displays the results of comparing the memory. Displays the contents of registers. Displays the contents of SFR. Selects SFR and I/O ports to be displayed in the SFR Window. Registers an I/O port to be displayed in the SFR Window. Displays, enables/disables, and deletes each event condition. Display, enable or disable, and delete software breaks. Registers event conditions. Registers and sets break event conditions. Saves the display information of the current window to a view file. Loads the view file of each window. Saves the setting information of the current window to a setting file. Loads the setting file of each window. Initializes the ID78K0S-QB,CPU, and symbol information. Terminates the ID78K0S-QB. Displays the version of the ID78K0S-QB. Inputs commands. Displays the types of fonts displayed. Selects the file to be set. User's Manual U17287EJ1V0UM 73 CHAPTER 6 WINDOW REFERENCE 6.2 Explanation of Windows This section explains each window or dialog box as follows: Window Name / Dialog box Name Briefly explains the function of the window or dialog box and points to be noted. In addition, the display image of the window or dialog box is also illustrated. Items of related operation are also explained. Opening Explains how to open the window or dialog box. Explanation of each area Explains items to be set to or displayed in each area of the window or dialog box. Context menu Explains the context menu that is displayed in the window when the right mouse button is clicked. From the context menu, convenient functions often used in this window can be selected with a single action (window only). Function buttons Explains the operation of each button in the window or dialog box. Related operations Explains the operation of a window or dialog box related to this window or dialog box. 74 User's Manual U17287EJ1V0UM CHAPTER 6 WINDOW REFERENCE Main Window This window is automatically opened when the ID78K0S-QB is started up and initialized. In the ID78K0S-QB, other windows are manipulated from this window. (Refer to "Table 6-1 Window List".) Execution of the user program is controlled in this window. Execution of the user program is controlled in the following three modes: - Source mode (Debugs the user program at the source level.) - Instruction mode (Debugs the user program at the instruction level.) - Auto mode (Automatically selects the source mode or instruction mode.) Figure 6-1 Main Window - Menu bar - Toolbar - Window display area - Status bar User's Manual U17287EJ1V0UM 75 CHAPTER 6 WINDOW REFERENCE Menu bar (1) [File] menu (2) [Edit] menu (3) [View] menu (4) [Option] menu (5) [Run] menu (6) [Event] menu (7) [Browse] menu (8) [Jump] menu (9) [Window] menu (10) [Help] menu (1) [File] menu Open... Loads a view file, source file, or text file. Opens the View File Load Dialog Box. The operation differs depending on the extension of the file selected in the dialog box. Saves the contents displayed on the current window to the file whose name is specified. Opens the View File Save Dialog Box. Closes the current window. Downloads a file. Opens the Download Dialog Box. Uploads a file. Opens the Upload Dialog Box. Manipulates a project file. Opens a project file. Opens the Project File Load Dialog Box. Overwrites the current status to the project file currently being read to the ID78K0SQB. Saves the current status to a specified project file. Opens the Project File Save Dialog Box. Manipulates a setting file. Opens a setting file. Opens the Environment Setting File Load Dialog Box. Saves the setting in the current window to the setting file. Opens the Environment Setting File Save Dialog Box. Initializes the target CPU, symbols, and the ID78K0S-QB. Opens the Reset Debugger Dialog Box. Terminate the ID78K0S-QB. Opens the Exit Debugger Dialog Box. Lists the names of the files opened. Save As... Close Download... Upload... Project Open... Save Save As... Environment Open... Save As... Debugger Reset... Exit (Open file) 76 User's Manual U17287EJ1V0UM CHAPTER 6 WINDOW REFERENCE (2) [Edit] menu Cut Copy Paste Write in Restore Memory Fill... Copy... Compare... Modify... Edit Source Cuts a selected character string and saves it to the clipboard buffer. Copies a selected character string and saves it to the clipboard buffer. Pastes the contents of the clipboard buffer to the text cursor position. Writes the modified contents to the target. Cancels the modification. Manipulates the memory contents. Fills the memory contents with specified codes. Opens the Memory Fill Dialog Box. Copies the memory contents. Opens the Memory Copy Dialog Box. Compares the memory contents. Opens the Memory Compare Dialog Box. Cannot be selected. Opens the source file displayed in the active the Source Window with the editor specified by the PM plus when the PM plus runs. (3) [View] menu The [View] menu contains common parts as well as dedicated parts added according to the active window. For details about the dedicated parts, refer to the description of each window. (a) Common items Search... Performs a search. Opens the search dialog box corresponding to the current window. Same operation as the Move... Quick Watch... Add Watch... View Watch Change Watch... Delete Watch Symbol... User's Manual U17287EJ1V0UM 77 CHAPTER 6 WINDOW REFERENCE (4) [Option] menu Tool Bar Status Bar Button Source Mode Instruction Mode Auto Mode Selects whether the toolbar is displayed (default) or not. Selects whether the status bar is displayed (default) or not. Selects whether the buttons on each window are displayed (default) or not. Executes step execution at the source level (in line units). Executes step execution at the instruction level (in instruction units). Automatically selects step execution at the source level or step execution at the instruction level (default). Step execution is performed at the source level (in a mode other than mixed display mode) if the Source Window is active. It is performed at the instruction level if the Assemble Window is active. If neither window is active, step execution is performed at the source level. Sets the environment. Opens the Configuration Dialog Box. Sets extended functions. Opens the Extended Option Dialog Box. Sets the sampling range for the RRM function. Opens the RRM Dialog Box. Sets the ID78K0S-QB options. Opens the Debugger Option Dialog Box. Adds user-defined I/O ports. Opens the Add I/O Port Dialog Box. Cannot be selected. Cannot be selected. Configuration... Extended Option... RRM Setting... Debugger Option... Add I/O Port ... Trace Clear Coverage (5) [Run] menu Restart Resets the CPU and executes the program. Same operation as this button. Stop Forcibly stops program execution. Same operation as this button. Go Executes the program from the current PC. Same operation as this button. Ignore break points and Go Ignores break points being set, and executes the program. Same operation as this button. Return Out The user program is executed until execution returns Same operation as the this button. Note: This command is used for a function described in C language. Step In Executes the instructions in the program one by one (step execution). If a function or subroutine is called, its instructions are executed one by one. Same operation as this button. 78 User's Manual U17287EJ1V0UM CHAPTER 6 WINDOW REFERENCE Next Over Executes the instructions in the program one by one (Next step execution). If a function or subroutine is called, its instructions are not executed on a stepby-step basis. Same operation as this button. Start From Here Come Here Go & Go Executes the program from the cursor position on the Source Window or the Assemble Window. Executes the program from the current PC to the cursor position in the Source Window or the Assemble Window. Continues executing the program. If a break occurs because a break condition is satisfied, the window is updated and the program is executed again. Same operation as clicking this button each time a break has occurred. Slowmotion Continues step execution. Each time step execution has been performed, the window is updated and then step execution is performed again. Same operation as clicking this button each time a break has occurred. CPU Reset Resets the CPU. Same operation as the this button. Change PC Break Point Software Break Point Delete All Software Break Uncond. Trace ON Cond. Trace ON Tracer Control Mode Coverage Start/ Coverage Stop Timer Start/ Timer Stop Tracer Start/ Tracer Stop Sets the address at the cursor position in the Source Window or the Assemble Window to the PC. Cannot be selected. Sets or cancels a software breakpoint at the cursor position in the Source Window or the Assemble Window. Deletes all the set software break points. Cannot be selected. Cannot be selected. Cannot be selected. Cannot be selected. Cannot be selected. Cannot be selected. User's Manual U17287EJ1V0UM 79 CHAPTER 6 WINDOW REFERENCE (6) [Event] menu Event Manager Manages various event conditions. Opens the Event Manager. Same operation as this button. Software Break Manager Event... Manages software break event conditions.Opens the Software Break Manager. Registers an event condition. Opens the Event Dialog Box. Same operation as this button. Event Link... Break... Cannot be selected. Registers and sets a break condition. Opens the Break Dialog Box. Same operation as this button. Trace... Snap Shot... Stub... Timer... DMM... Delay Count... (7) [Browse] menu Source Text Displays a source text. Opens the Source Window. If there is a Source Window already open in the active status, it is opened in the static status. Same operation as this button. Assemble Displays the disassemble results. Opens the Assemble Window. If there is a Assemble Window already open in the active status, it is opened in the static status. Same operation as this button. Memory Displays the contents of the memory. Opens the Memory Window. If there is a Memory Window already open in the active status, it is opened in the static status. Same operation as this button. Watch Displays the watch contents. Opens the Watch Window. Same operation as this button. Register Displays the register contents. Opens the Register Window. Same operation as this button. SFR Opens SFR. Opens the SFR Window. Same operation as this button. Local Variable Displays the local variable. Opens the Local Variable Window. Same operation as this button. Cannot be selected. Cannot be selected. Cannot be selected. Cannot be selected. Cannot be selected. Cannot be selected. 80 User's Manual U17287EJ1V0UM CHAPTER 6 WINDOW REFERENCE Stack Trace Displays the stack trace results. Opens the Stack Window. Same operation as this button. Trace Coverage Console Others (8) [Jump] menu Source Text Cannot be selected. Cannot be selected. Opens the Console Window. Displays other windows. Displays a user-defined window list. Displays the corresponding source text and source line, using the data value selected in the current window as the jump destination address. If no line information exists at the jump destination address, however, you cannot jump. Opens the Source Window. If an active Source Window is open, that window is displayed in the forefront (so that it can be manipulated). Disassembles and displays the results from the jump destination address specified by the data value selected in the current window. Opens the Assemble Window. If an active Assemble Window is open, that window is displayed in the forefront (so that it can be manipulated). Displays the memory contents from the jump destination address specified by the data value selected in the current window. Opens the Memory Window. If an active Memory Window is open, that window is displayed in the forefront (so that it can be manipulated). Cannot be selected. Assemble Memory Coverage (9) [Window] menu New Window Opens a new window displaying the same contents as those of the current window.This menu is valid only when the current window is the Source Window, the Assemble Window, or the Memory Window. Cascade display of the windows in the main window. Tile display of the windows in the main window. Rearranges the icons in the main window. Closes all windows, except the main window. Updates the contents of the window with the latest data. Sets the window in the active status. Sets the window in the static status. Lists the windows that are open. The window with the check mark shown on the side of the figure is the current window By selecting a window name, the selected window is used as the current window. Cascade Tile Arrange Icons Close All Refresh Active Static (Open Window) User's Manual U17287EJ1V0UM 81 CHAPTER 6 WINDOW REFERENCE (10) [Help] menu ID78K0S-QB Help Command Reference Main Window Current Window About... Displays the help of the debugger. Opens the Help window of COMMAND REFERENCE. Displays the help of the main window. Displays the help of the current window. Displays the version of the ID78K0S-QB. Opens the About Dialog Box. Toolbar (1) Meaning of each button (2) Operation of toolbar (1) Meaning of each button The meaning of each button on the toolbar is as follows. When the mouse cursor is placed on a button of the toolbar, a tool hint pops up several seconds later. Stops execution of the user program. Same function as [Run] menu -> [Stop] . Resets the CPU and executes the user program. Same function as [Run] menu -> [Restart] . Executes the user program from the current PC without resetting the CPU. Same function as [Run] menu -> [Go] . Ignores break points being set, and executes the user program. Same function as [Run] menu -> [Ignore break points and Go] . The user program is executed until execution returns. Same function as [Run] menu -> [Return Out] . Note: This command is used for a function described in C language. Step execution (executes instructions in the program one by one.) If a function or subroutine is called, its instructions are executed one by one. Same function as [Run] menu -> [Step In]. Next step execution (executes the program, assuming a function/call statement as one step.) If a function or subroutine is called, its instructions are not executed on a step-by-step basis. Same function as [Run] menu -> [Next Over]. Resets the CPU. Same function as [Run] menu -> [CPU Reset]. Opens the View File Load Dialog Box. Same function as [File] menu -> [Open]. Opens the Download Dialog Box. Same function as [File] menu -> [Download]. Opens the Project File Load Dialog Box. Same function as [File] menu -> [Project] -> [Open]. Stop ReGo Go Go Ret Step Over Res Open Load Proj 82 User's Manual U17287EJ1V0UM CHAPTER 6 WINDOW REFERENCE Src Displays the source text. Opens the Source Window. Same function as [Browse] menu -> [Source Text]. Displays the disassemble results. Opens the Assemble Window. Same function as [Browse] menu ->[Assemble]. Displays the contents of the memory. Opens the Memory Window. Same function as [Browse] menu -> [Memory]. Displays the watch contents. Opens the Watch Window. Same function as [Browse] menu -> [Watch]. Displays the register contents. Opens the Register Window. Same function as [Browse] menu -> [Register]. Displays the contents of SFR. Opens the SFR Window. Same function as [Browse] menu -> [SFR]. Displays the local variable contents. Opens the Local Variable Window. Same function as [Browse] menu -> [Local Variable]. Displays the stack trace results. Opens the Stack Window. Same function as [Browse] menu -> [Stack Trace]. Cannot be selected. Asm Mem Wch Reg SFR Loc Stk TrW Cannot be selected. Cov Mgr Evn Opens the Event Manager. Same function as [Event] menu -> [Event Manager]. Registers and sets events. Opens the Event Dialog Box. Same function as [Event] menu -> [Event]. Registers and sets break events. Opens the Break Dialog Box. Same function as [Event] menu -> [Break]. Cannot be selected. Trc Cannot be selected. Tim (2) Operation of toolbar Whether the tool bar is displayed or not can be specified by selecting [Option] menu -> [Tool Bar]. This toolbar can be displayed in the following two modes. The modes are selected in the Debugger Option Dialog Box. Figure 6-2 Toolbar (Picture Only) Brk Figure 6-3 Toolbar (Picture and Text) User's Manual U17287EJ1V0UM 83 CHAPTER 6 WINDOW REFERENCE Window display area This area (at the center) displays various debug windows. The displayed window can be changed in size or an icon can be created in this area. Status bar The status bar displays the status of the ID78K0S-QB and in-circuit emulator. While the user program is being executed, the status bar is displayed in red. Whether the status bar is displayed or not can be specified by selecting [Option] menu -> [Status Bar]. Figure 6-4 Status Bar (1) Program name Source name Line number (2) Function name (3) PC value (4) CPU status (5) CPU status (6) Break Cause (7) STEP mode Displays the program file name indicated by the PC value. Displays the source file name indicated by the PC value. Displays the line number indicated by the PC value. Displays the function name indicated by the PC value. Displays the current PC value. Refer to "Table 6-2 CPU Status". Refer to "Table 6-3 IE Status". (If there are two or more the statuses, they delimited with '|' and displayed.) Refer to "Table 6-4 Break Cause". Displays the step execution mode. Displays that the following modes are selected from the [Option] menu: SRC.............. Source mode INST ............. Instruction mode AUTO ........... Automatic mode Displays the key input mode. INS ............... Insertion mode OVR.............. Overwrite mode The Memory Window is fixed to OVR mode. (8) Key input mode 84 User's Manual U17287EJ1V0UM CHAPTER 6 WINDOW REFERENCE Table 6-2 CPU Status Display HALT STOP RESET POW OFF Halt mode Stop mode Reset mode Power is not supplied to the target Meaning Table 6-3 IE Status Display RUN STEP BREAK Meaning User program execution in progress (the color of the status bar changes). Step execution in progress Break occurring Table 6-4 Break Cause Display Manual Break Temporary Break Event Break Software Break Uninitialize Stack Pointer Forced break Temporary break Break by event Software break Break due to failure to perform stack pointer initialization Meaning User's Manual U17287EJ1V0UM 85 CHAPTER 6 WINDOW REFERENCE Configuration Dialog Box This dialog box is used to display and set the ID78K0S-QB operation environment. (Refer to "5.1 Setting Debugging Environment".) This dialog box is automatically displayed after the ID78K0S-QB is started up. However, no setting is required to read a project as the results of reading the project file are reflected in this dialog box. (Refer to "5.11.1 Debugging environment (project file)".) Figure 6-5 Configuration Dialog Box - Opening - Explanation of each area - Function buttons Opening (Automatically when the ID78K0S-QB is started up) Select [Option] menu -> [Configuration...]. 86 User's Manual U17287EJ1V0UM CHAPTER 6 WINDOW REFERENCE Explanation of each area (1) Chip (2) Internal ROM/RAM (3) Main Clock (4) Sub Clock (5) ID Code (6) Peripheral Break (7) Monitor Clock (8) Target Power Off (9) Fail-safe Break (10) Mask (11) Memory Mapping (1) Chip This area is used to select the chip name. A chip name is selected from the drop-down list. On the drop-down list, only the chip names registered to the registry from the device file installer are displayed. This area can be specified only when the debugger is started up. Remark By default, the type selected at the previous startup is displayed, but if that type is not registered, the first type registered is displayed. (2) Internal ROM/RAM This area is used to set the size of the internal ROM and internal RAM of the CPU. The sizes of the internal ROM and RAM for the device files are fixed in the ID78K0S-QB. (3) Main Clock This area is used to select the main clock source input to the CPU. In this area, if the oscillator is not connected to the clock socket on the emulator, the setting is fixed to "System". If the oscillator is connected, the setting is fixed to "Clock Board". Clock Board External System The clock for the clock socket on the emulator is used as the main clock for the CPU Cannot be selected. A divided frequency from the internal emulator system clock is used as the main clock for the CPU. (default) This value is selected from a drop-down list. (4) Sub Clock Cannot be selected in this area. (5) ID Code Cannot be selected in this area. User's Manual U17287EJ1V0UM 87 CHAPTER 6 WINDOW REFERENCE (6) Peripheral Break This area is used to specify whether the peripheral emulation function of in-circuit emulator is stopped during a break. Break Non Break Peripheral emulation functions are stopped during breaks. Peripheral emulation functions are not stopped during breaks (default). Remark The following peripheral macros are compatible with Peripheral Breaks. - 16-bit timer/event counter 00 - 8-bit timer 80 - 8-bit timer H1 Regardless of the settings in this area, the operations of the watchdog timer are stopped during breaks. Peripheral macros other than the above, operate during breaks. (7) Monitor Clock This area is used to specify whether the operation clock of the monitor program is switched from the subclock to the main clock during a break. This area does not have to be set with a product without a subclock. System The operation clock is switched to the main clock and the monitor program is executed (default). Caution: In theID78K0S-QB, the clock is changed by manipulating PCC, but not while the main clock is stopped. If the operation clock is switched to the main clock during a break, the clock is returned to the previous setting when execution returns to the user program. The monitor program is executed with the clock selected by the user program. User (8) Target Power Off This area is used to select whether the Power Off Emulation function is valid or not . When debugging with the target system unconnected, select "Not Permit". Permit Not Permit Power Off emulation function is valid. Power Off emulation function is invalid. Remark If "Not Permit" is selected when the target system is connected, and if a target reset occurs during a RUN (execution), a break occurs after the debugger is reset. (9) Fail-safe Break Cannot be selected in this area. 88 User's Manual U17287EJ1V0UM CHAPTER 6 WINDOW REFERENCE (10) Mask This area is used to mask the signal sent from the target. The signal of a masked pin is not input to the in-circuit emulator. Mask a pin only when the operation of the target is not stable at the debugging stage. Remark When the target system is unconnected, "TARGET RESET" is masked regardless of the settings. (11) Memory Mapping Cannot be selected in this area. Function buttons OK Cancel Restore Project... About... Help Validates the current environment. Sets the environment and closes this dialog box. Cancels the changes and closes this dialog box. Restores the previous settings before this dialog box was opened. Opens the Project File Load Dialog Box. If an error occurs while a project file is being opened or read, the ID78K0S-QB can no longer continue and is terminated. Opens the About Dialog Box. Displays the help window of this window. User's Manual U17287EJ1V0UM 89 CHAPTER 6 WINDOW REFERENCE Extended Option Dialog Box This dialog box is used to display and set the extended options of the ID78K0S-QB. (Refer to "5.1 Setting Debugging Environment".) Figure 6-6 Extended Option Dialog Box - Opening - Explanation of each area - Function buttons Opening Select [Option ] menu -> [Extended Option ...] . Explanation of each area (1) Realtime Monitor (2) Flash Self Mode (3) On Mouse Click (4) Clear Register When Reset (5) Clear Trace Memory Before Run (6) Break Sound (7) Verify Check 90 User's Manual U17287EJ1V0UM CHAPTER 6 WINDOW REFERENCE (1) Realtime Monitor Set the real-time monitor (refer to "5.10 Real-time Monitor Function"). The function of the selected item is enabled. Realtime Readout Break When Readout Performs real-time monitoring in real time. Cannot be selected. (a) Redraw Interval Specify the sampling time (ms) of the real-time monitor function function. The sampling time can be specified in 100-ms units from 0 to 65500. If 0 is specified, or if this area is blank, the data is not displayed in real time. (2) Flash Self Mode Cannot be selected in this area. (3) On Mouse Click Cannot be selected in this area. (4) Clear Register When Reset Select this checkbox to set the SP register to 0xfedf and all the banks of the general-purpose registers (X, A, C, B, E, D, L, H) to 0x0 at CPU reset. Under the default setting, the registers are not cleared. (5) Clear Trace Memory Before Run Cannot be selected in this area. (6) Break Sound If the check box is checked, a beep sound is issued when a break occurs. (7) Verify Check This area is used to specify whether a verify check is performed when data has been written to memory. A verify check is performed when download, memory fill, or memory copy is executed. A verify check is also performed when a variable or data is changed in the Watch Window or the Memory Window and is written to memory. Function buttons OK Cancel Restore Help Validates the settings and closes this dialog box. Cancels the changes and closes this dialog box. Restores the previous settings before this dialog box was opened. Displays the help window of this window. User's Manual U17287EJ1V0UM 91 CHAPTER 6 WINDOW REFERENCE RRM Dialog Box This dialog box is used to set the sampling range for the RRM function. (Refer to "5.10 Real-time Monitor Function".) Up to 8 locations can be specified in 2-byte units as the sampling range. The total of the sizes specified for the 8 locations cannot exceed 16 bytes. Figure 6-7 RRM Dialog Box - Opening - Explanation of each area - Function buttons Opening The settings of this dialog box when it is opened differ depending on the opening method. (a) When settings are performed from RRM Dialog Box The dialog box is opened by selecting [Option] menu -> [RRM Setting...]. In this case, the data in (1) Address and (2) Size are input manually. (b) When settings are performed from the Memory Window This dialog box is opened by opening the Memory Window, selecting an address in the window, and then selecting [RRM Setting...] from the context menu. In this case, the selected address is displayed in an empty row in (1) Address, 2 bytes is displayed in an empty row in (2) Size, and the value obtained by converting the address to a symbol is displayed in an empty row in (3) Symbol. However, if the total of the sizes specified for the 8 locations already exceeds 16 bytes, the dialog box opens but no value can be set. 92 User's Manual U17287EJ1V0UM CHAPTER 6 WINDOW REFERENCE (c) When settings are performed from the Watch Window This dialog box is opened by opening the Watch Window, selecting a variable in the window, and then selecting [RRM Setting...] from the context menu. In this case, the value obtained by converting the variable into an address is displayed in an empty row in (1) Address, 2 bytes is displayed in an empty row in (2) Size, and the value obtained by converting the variable to a symbol is displayed in an empty row in (3) Symbol. However, if the total of the sizes specified for the 8 locations already exceeds 16 bytes, the dialog box opens but no value can be set. Explanation of each area (1) Address (2) Size (3) Symbol (4) Size Total (1) Address This area is used to specify the sampling start address for the RRM function. The default radix for inputting a numeric value is hexadecimal. An address can be also specified by a symbol or expression. (Refer to "Table 5-5 Specifying Symbols".) Following input, click the User's Manual U17287EJ1V0UM 93 CHAPTER 6 WINDOW REFERENCE Function buttons OK Cancel Restore Default Delete Jump Validates the settings and closes this dialog box. Closes this dialog box. Restores the input data to the original status. Clears the current setting and sets the internal RAM start address in the first row in (1) Address, and 16 in the first row in (2) Size. Deletes the setting for the numbers with a focus. Opens the Memory Window and displays the addresses in (1) Address whose numbers have a focus. Jump is performed for Memory Window that are in the active status. If multiple memory windows are to be opened, they must be set in the static status. (Refer to "5.12.1 Active status and static status".) Enables the settings. Displays this dialog box online help files. Apply Help 94 User's Manual U17287EJ1V0UM CHAPTER 6 WINDOW REFERENCE Debugger Option Dialog Box This dialog box is used to display and set the various options of the ID78K0S-QB. Figure 6-8 Debugger Option Dialog Box - Opening - Explanation of each area - Function buttons Opening Select [Option] menu -> [Debugger Option...]. Explanation of each area (1) Source Path (2) Default Extension (3) Open File History (4) Font (5) Project File: (6) Tool Bar Pictures (7) Kanji (8) Tab Size User's Manual U17287EJ1V0UM 95 CHAPTER 6 WINDOW REFERENCE (9) Startup Routine (10) DisAssemble (11) Watch Default (1) Source Path This area is used to specify the directory in which a source file or text file is searched. (a) Base: The directory is the basis of a relative path is displayed. The base directory is determined in the following sequence: (i) (ii) Directory to which the project file has been loaded Directory to which a load module or hex file has been loaded last (iii) Current directory of Windows (b) Text box This area is used to specify the directory searched. To specify a directory, either directly input one to the text box, or click the 96 User's Manual U17287EJ1V0UM CHAPTER 6 WINDOW REFERENCE (2) Default Extension This area is used to specify the default extension. Delimit extensions with " " (blank),";" (semicolon) or "," (comma). Source File: Set the extension of a source file that is displayed when the Browse Dialog Box is opened by selecting [File] menu -> [Open...]. The default extension is " *.c, *.s , *.asm". Set the extension of a load module that is displayed when the Download Dialog Box is opened. The default extension is " *.lnk, *.lmf ". Load Module: (3) Open File History This area is used to set the number of histories of the open file displayed in the bottom field of the [File] menu. The default value is 4. If 0 is set, no history is displayed on the menu. (4) Font This area is used to specify the font displayed on the Source Window, the Watch Window, the Quick Watch Dialog Box, the Local Variable Window, and the Stack Window. Clicking the (b) Auto Load: Sets whether the project file is automatically loaded at the ID78K0S-QB start up. On Off Automatically loads the project file at the ID78K0S-QB start up. Specify the project file to be loaded in (c) Load Project File. Does not automatically loads the project file at the ID850QB start up. (default) Load Project File (c) Specify the project file to be loaded automatically. Set a project file name by inputting from the keyboard or clicking the User's Manual U17287EJ1V0UM 97 CHAPTER 6 WINDOW REFERENCE (6) Tool Bar Pictures This area sets the buttons to be displayed on the tool bar. (Refer to " Toolbar".) Pictures and Text Pictures only Displays a button on which a graphic and character are displayed. Displays a button with only graphic (default). (7) Kanji Cannot be selected in this area. (8) Tab Size This area is used to set the tab size for each extension when files are displayed. (a) Extension: Set an extension. Input an extension from the keyboard, or select one from the drop-down list. (b) Tab Size: Select the tab size. Select how many spaces are displayed as a tab code (2, 4, or 8). (c) Tab List: Displays the tab size set for each extension. (d) Caution1 If the specified symbol is not correct, the source file cannot be opened until the PC reaches the address range of the corresponding source file. In addition, the start-up routine cannot be skipped by step execution. Caution2 Be sure to specify this area. If this area is blank, the dialog box cannot be closed. 98 User's Manual U17287EJ1V0UM CHAPTER 6 WINDOW REFERENCE (10) DisAssemble This area is used to set for disassemble display. (a) Show Offset: Specifies whether an offset (symbol + offset) is displayed during disassemble display. When the offset is not displayed, only a symbol that matches a numeric value is displayed, if any. If no matching symbol is found, the numeric value is displayed as a hexadecimal number unchanged. Label Mnemonic Specifies whether the offset is displayed in the Label field. In the default condition, the offset is not displayed. Specifies whether the offset is displayed in the Mnemonic field. In the default condition, the offset is displayed. (b) Register Name: This area is used to select the method of displaying register names in mnemonics during disassemble display. Function Name Absolute Name Displays register names as function names or nicknames (default). Displays register names as absolute names. (11) Watch Default This area is used to specify a symbol to be watched in the Watch Window etc. . (a) Size: Sets the default display size of data if [Adaptive] is specified. Byte Word Double Word 8-bit display(default) 16-bit display 32-bit display (b) Radix: Sets the default radix in which data is to be displayed if [Proper] is specified. Hex Dec Oct Bin String Displays data in hexadecimal numbers (default). Displays data in decimal numbers. Displays data in octal numbers. Displays data in binary numbers. Displays data in character strings. User's Manual U17287EJ1V0UM 99 CHAPTER 6 WINDOW REFERENCE (c) Show Variable Type: Select the display/non-display of variable type is specified. On Off Displays the type of a variable. Does not display the type of a variable (default). (d) Language: Select the display/non-display of type of variable is specified. C ASM Displays a C-like base number (default). Displays an assembly language-like base number. Function buttons OK Cancel Restore Help Validates the settings and closes this dialog box. Cancels the changings and closes this dialog box. Restores the previous settings before this dialog box was opened. Displays this dialog box online help files. 100 User's Manual U17287EJ1V0UM CHAPTER 6 WINDOW REFERENCE Project File Save Dialog Box This dialog box is used to save the current debugging environment to a project file. (Refer to "5.11.1 Debugging environment (project file)".) Project files can be newly saved or saved under an existing file name in this dialog box. Figure 6-10 Project File Save Dialog Box - Opening - Explanation of each area - Function buttons Opening Select [File] menu -> [Project] -> [Save As...]. (To save a file of same name as a project file previously loaded or saved, select [File] menu -> [Project] -> [Save].) Explanation of each area (1) Save in:, File name: (2) Save as type: User's Manual U17287EJ1V0UM 101 CHAPTER 6 WINDOW REFERENCE (1) Save in:, File name: This area is used to specify a file name. A file name can be directly input, or selected from the list at the upper part of this area. Up to 257 characters string with a extension can be specified. (2) Save as type: This area is used to specify the extension (*.prj) of the project file to be saved. If the extension is omitted, "*.prj" is appended as the default extension. Function buttons Save Cancel Help Saves the debugging environment to the selected file. After saving, the dialog box is closed. Closes this dialog box without saving the file. Displays this dialog box online help files. 102 User's Manual U17287EJ1V0UM CHAPTER 6 WINDOW REFERENCE Project File Load Dialog Box This dialog box is used to restore the debugging environment to the debugging environment saved to the project file. (Refer to "5.11.1 Debugging environment (project file)".) If there is an active Source Window after a project file has been loaded, it is displayed at the top. Caution Following ID78K0S-QB startup, if a project file with settings that differ from those of the target device at startup has been loaded, the target device specified at startup is used. Figure 6-11 Project File Load Dialog Box - Opening - Explanation of each area - Function buttons Opening Click the Proj button, or select [File] menu -> [Project] -> [Open...]. Explanation of each area (1) Look In:, File name: (2) Files of type: User's Manual U17287EJ1V0UM 103 CHAPTER 6 WINDOW REFERENCE (1) Look In:, File name: This area is used to specify the file name to be loaded. A file name can be directly input from the keyboard, or selected from the list. Up to 257 characters string with a extension can be specified. (2) Files of type: This area is used to specify the extension (*.prj) of the file to be loaded. Function buttons Open Cancel Help Loads the selected file. After loading the file, this dialog box is closed. Closes this dialog box without executing anything. Displays this dialog box online help files. 104 User's Manual U17287EJ1V0UM CHAPTER 6 WINDOW REFERENCE Download Dialog Box This dialog box is used to select the name and format of a file to be downloaded, and downloads memory contents to the in-circuit emulator and the target system. (Refer to "5.2 Download Function, Upload Function".) If a load module file has been downloaded, the corresponding source file is searched, and the Source Window is automatically opened. Caution If a file other than a load module file is loaded, source debugging cannot be executed. Figure 6-12 Download Dialog Box Remark The following dialog box appears while downloading and the downloading can be can celled at any time. This dialog box is closed automatically after completing downloading. Figure 6-13 The Progress of Download - Opening - Explanation of each area - Function buttons User's Manual U17287EJ1V0UM 105 CHAPTER 6 WINDOW REFERENCE Opening Click the Load button, or select [File] menu -> [Download...]. Explanation of each area (1) Look In:, File name: (2) Files of type: (3) Load (4) Reset (5) Offset Address: (1) Look In:, File name: This area is used to specify a file name. A file name can be directly input from the keyboard, or selected from the list at the upper part of this area. Up to 257 characters string with a extension can be specified. (2) Files of type: This area is used to specify the type (extension) of the file to be downloaded. (Refer to "Table 5-2 Type of File That Can Be Downloaded".) Remark These are default extensions; other extensions can also be used. The default extension of the displayed load module can also be specified in the Debugger Option Dialog Box. (3) Load This area is used to set a load condition. This setting is valid only if a file in the load module format is specified. This setting is valid only if a file in the load module format is specified. Symbol Object Specifies whether symbol information is read or not. Specifies whether object information is read (when checked, default) or not. (The object information is read even if this button is not checked when a HEX file is loaded.) Cannot be selected. Erase 106 User's Manual U17287EJ1V0UM CHAPTER 6 WINDOW REFERENCE (4) Reset This area is used to set a reset condition. This setting is valid only if a file in the load module format is specified. Symbol CPU (5) Offset Address: This area is used to specify the offset address that is used when a file is loaded (for binary data, specify the start address). An address can be also specified by a symbol or expression. (Refer to "Table 5-5 Specifying Symbols".) The default radix for inputting a numeric value is hexadecimal. Specifies whether symbol information is reset or not. Fixed to checked status (always reset). Specifies whether the CPU is reset or not. (Checked, default.) Function buttons Open Cancel Help Restore Loads the selected file. After loading the file, this dialog box is closed. Closes this dialog box without loading the file. Displays this dialog box online help files. Restores the input data to the original status. User's Manual U17287EJ1V0UM 107 CHAPTER 6 WINDOW REFERENCE Upload Dialog Box This dialog box is used to set the name and format of the file to be saved, and save the set memory contents, etc., to that file. (Refer to "5.2 Download Function, Upload Function".) Figure 6-14 Upload Dialog Box - Opening - Explanation of each area - Function buttons Opening Select [File] menu -> [Upload...]. Explanation of each area (1) Save in:, File name: (2) Save as type: (3) Save Address: 108 User's Manual U17287EJ1V0UM CHAPTER 6 WINDOW REFERENCE (1) Save in:, File name: This area is used to specify the file name to be saved. A file name can be directly input from the keyboard, or selected from the list. Up to 257 character string with a extension can be specified. (2) Save as type: This area is used to specify the type (extension) of the file to be saved. The format of the data to be saved is determined by the extension. (Refer to "Table 5-3 Type of File That Can Be Uploaded") However, if "All (*.*) " is selected, the data is saved in the default Intel extended Hex format. Remark Extensions other than those listed can also be used. (3) Save Address: This area is used to specify the range of address to be saved. An address can be also specified by a symbol or expression. (Refer to "Table 5-5 Specifying Symbols".) The default radix for inputting a numeric value is hexadecimal. Function buttons Save Cancel Help Restore Saves the file according to the setting. Closes this dialog box without executing anything. Displays this dialog box online help files. Restores the status before this dialog box was opened. User's Manual U17287EJ1V0UM 109 CHAPTER 6 WINDOW REFERENCE Source Window This window is used to displays source files or text files. (Refer to "5.3 Source Display, Disassemble Display Function".) In addition to Breakpoint setting and Mixed display mode (Source Window), a number of other operations using Context menu, Function buttons, etc., can be performed in this window. Moreover, there are two statuses, Active status and static status, for this window. Moreover, the items selected in the window with Drag & drop function can be used in another window. (Refer to "5.12 Functions Common to Each Window".) Caution If program codes is described in an include file and these codes are included in multiple files, the line numbers and addresses do not correspond on a one-to-one bases. In such an include file, function that indicates the correspondence relationship between line numbers and addresses dose not correctly operate. Figure 6-15 Source Window - Opening - Explanation of each area - [View] menu (Source Window-dedicated items) - Context menu - Function buttons Opening Click the Src button, or select [Browse] menu -> [Source Text]. (This window is automatically opened if the corresponding source file exists after the download module file has been downloaded. ) 110 User's Manual U17287EJ1V0UM CHAPTER 6 WINDOW REFERENCE Explanation of each area (1) Point mark area (2) Current PC mark area (3) Line number/address display area (4) Source text display area (1) Point mark area This area is used for the Event Setting Status (Event Mark) and program codes (*) display, as well as Breakpoint setting. Remark The program code is displayed only when the symbol information downloaded by the load module is read. Breakpoints can be set or deleted by clicking with the mouse on this program code. (if "*" is not displayed for the line, the breakpoint is set on the line above or below the line, whichever has "*" displayed.) If an event has been set for the corresponding line, one of the marks listed in the following table is displayed. Table 6-5 Event Setting Status (Event Mark) Mark B (blue) (2) Current PC mark area The mark ">", which indicates the current PC value (PC register value), is displayed in this area. Clicking this mark with the mouse displays a pop-up window that shows the PC register value. By double-clicking the current PC mark area, the program can be executed up to a specified line. (3) Line number/address display area This area displays the line numbers of a source file or text file. Red indicates line numbers for which corresponding program code exists, and black indicates line numbers for which corresponding program code does not exist. In the Mixed display mode (Source Window), disassemble display addresses are displayed in gray. Software breakpoint is set. Meaning User's Manual U17287EJ1V0UM 111 CHAPTER 6 WINDOW REFERENCE (4) Source text display area This area displays source files and text files. Yellow indicates the current PC line, and red indicates lines where a valid breakpoint is set. In the Mixed display mode (Source Window), source lines are displayed in the regular color. Moreover, this area also provides the following functions for lines (start address of program code) and addresses where the cursor has been placed. - [Come Here] , [Start From Here] (Refer to "Table 5-8 Type of Execution") - Drag & drop function - Context menu Caution If a Program code does not exist on the source line, the top address of the line above or below the line on which a program code exists is manipulated by these functions. These functions cannot be performed in the following cases. The corresponding menu will be dimmed and cannot be selected. - If a file other than a source file is displayed - While the user program is being executed [View] menu (Source Window-dedicated items) The following items are added in the [View] menu, when the Source Window is active. Create Break Event Break when Access to this Variable Break when Write to this Variable Break when Read from this Variable Clear Event? Mix Sets a break event that occurs if the selected variable is accessed. Sets a break event that occurs if the selected variable is accessed for read/ write. Sets a break event that occurs if the selected variable is accessed for write. Sets a break event that occurs if the selected variable is accessed for read. Deletes a break event corresponding to the selected variable. Cannot be selected. Turns on/off Mixed display mode (Source Window). 112 User's Manual U17287EJ1V0UM CHAPTER 6 WINDOW REFERENCE Context menu Move... Mix Add Watch... Symbol... Moves the display position. Opens the Source Text Move Dialog Box. Turns on/off Mixed display mode (Source Window). Adds the specified data to the Watch Window. Opens the Add Watch Dialog Box. Displays the address of the specified variable or function, or the value of the specified symbol. Opens the Symbol To Address Dialog Box. Sets a break event that occurs if the selected variable is accessed for read/ write. Sets a break event that occurs if the selected variable is accessed for write. Sets a break event that occurs if the selected variable is accessed for read. Deletes a break event corresponding to the selected variable. Cannot be selected. Executes the program from the current PC to the cursor position. (Refer to "Table 5-6 Break Types".) Sets the address at the cursor position to the PC. Cannot be selected. Sets or deletes a software breakpoint at the cursor position. Disassembles and displays starting from the jump destination address specified by the data value at the cursor position. (Refer to "5.12.2 Jump function".) Opens the Assemble Window. If an active Assemble Window is open, that window is displayed in the forefront (so that it can be manipulated). Displays the memory contents starting from the jump destination address specified by the data value at the cursor position. (Refer to "5.12.2 Jump function".) Opens the Memory Window. If an active Memory Window is open, that window is displayed in the forefront (so that it can be manipulated). Cannot be selected. Break when Access to this Variable Break when Write to this Variable Break when Read from this Variable Clear Event? Come Here Change PC Break Point Software Break Point Assemble Memory Coverage User's Manual U17287EJ1V0UM 113 CHAPTER 6 WINDOW REFERENCE Function buttons Search... Opens the Source Search Dialog Box and searches a character string of the source text. If a character string is selected in the source text display area, the Source Search Dialog Box is opened to search the character string. If no character string is selected, the Source Search Dialog Box is opened with nothing specified to be searched. Specify a search method in the Source Search Dialog Box. The results of search is highlighted in the Source window. This is the same operation as selecting [View] menu -> [Search...]. Searches forward (upward on screen) for the text that satisfies the search condition set in the Source Search Dialog Box, starting from the address at the cursor position. This button is displayed as the << >> Stop(during a search) Watch Quick... Refresh Close 114 User's Manual U17287EJ1V0UM CHAPTER 6 WINDOW REFERENCE Source Search Dialog Box This dialog box is used to search the contents of a file in the Source Window. (Refer to "5.3.1 Source display".) By setting each item and then clicking the - Opening - Explanation of each area - Function buttons Opening When the Source Window is the current window, select [View] menu -> [Search...], or click the Explanation of each area (1) Find What (2) Match Case (3) Direction User's Manual U17287EJ1V0UM 115 CHAPTER 6 WINDOW REFERENCE (1) Find What This area is used to specify the data to be searched. (Up to 256 character.) In the default condition, the string selected in the window that called this dialog box is displayed. As necessary, the character string displayed can be changed. Up to 16 input histories can be recorded. (2) Match Case This should be checked to distinguish between uppercase and lowercase. (3) Direction This area is used to specify the direction of the search. Up Down Forward search. Searches data forward (upward on screen) from the current position of the cursor. Backward search. Searches data backward (downward on screen) from the current position of the cursor (default). Function buttons Find Next Searches the specified data in accordance with a given condition. If the specified character string is found as a result of a search, it is highlighted. To continue searching, click this button again. Sets the specified condition as the search condition and closes this dialog box. Stops searching. Closes this dialog box. (During searching, this button is replaced by the Set Find Stop (during searching) Cancel Help 116 User's Manual U17287EJ1V0UM CHAPTER 6 WINDOW REFERENCE Source Text Move Dialog Box This dialog box is used to specify a file to be displayed in the Source Window and the position from which displaying the file is to be started. (Refer to "5.3.1 Source display".) Figure 6-17 Source Text Move Dialog Box - Opening - Explanation of each area - Function buttons Opening When the Source Window is the current window, select [View] menu -> [Move...]. Explanation of each area (1) Option (2) To: User's Manual U17287EJ1V0UM 117 CHAPTER 6 WINDOW REFERENCE (1) Option This area is used to select the input mode when the display start position is specified. (a) Address/Symbol This should be selected to specify by an address (or symbol). (b) Line/File This should be selected to specify by a line number (or file name). Function buttons OK Cancel Restore Help Starts displaying the source text from the specified position. Closes this dialog box. Restores the status before this dialog box was opened. Displays this dialog box online help files. 118 User's Manual U17287EJ1V0UM CHAPTER 6 WINDOW REFERENCE Assemble Window This window is used to disassemble and display programs. It is also used to execute Online assembly. (Refer to "5.3 Source Display, Disassemble Display Function".) The results of online assembly are also reflected in the Memory Window. In addition to Breakpoint setting , a number of other operations using Context menu, Function buttons, etc., can be performed in this window. Moreover, there are two statuses, Active status and static status, for this window. Moreover, the items selected in the window with the Drag & drop function can be used in another window. (Refer to "5.12 Functions Common to Each Window".) Figure 6-18 Assemble Window - Opening - Explanation of each area - [View] menu (Assemble Window-dedicated items) - Context menu - Function buttons - Related operations Opening Click the Asm button, or select [Browse] menu -> [Assemble] . User's Manual U17287EJ1V0UM 119 CHAPTER 6 WINDOW REFERENCE Explanation of each area (1) Point mark area (2) Current PC mark area (3) Address specification area (4) Disassemble display area (1) Point mark area This area is used for Event Setting Status (Event Mark) and Breakpoint setting. (2) Current PC mark area The mark ">", which indicates the current PC value (PC register value), is displayed in this area. By double-clicking the current PC mark area, the program can be executed up to a specified line. (3) Address specification area This area displays the disassembly start address. (4) Disassemble display area This area displays the labels and code data of addresses, and disassembled mnemonics. This area displays source files and text files. Yellow indicates the current PC line, and red indicates lines where a valid breakpoint is set. It can be Online assembly in the mnemonic field. This area also provides the following functions: - [Come Here] , [Start From Here] (Refer to "Table 5-8 Type of Execution") - Drag & drop function - Context menu [View] menu (Assemble Window-dedicated items) The following items are added in the [View] menu, when the Assemble Window is active. Event? Cannot be selected. Context menu Move... Add Watch... Moves the display position. Opens the Address Move Dialog Box. Adds the specified data to the Watch Window. Opens the Add Watch Dialog Box. 120 User's Manual U17287EJ1V0UM CHAPTER 6 WINDOW REFERENCE Symbol... Displays the address of the specified variable or function, or the value of the specified symbol. Opens the Symbol To Address Dialog Box. Executes the program from the current PC to the cursor position. (Refer to "Table 5-6 Break Types".) Sets the address at the cursor position to the PC. Cannot be selected. Sets or deletes a software breakpoint at the cursor position. Displays the corresponding source text and source line, using the data value at the cursor position as the jump destination address. (Refer to "5.12.2 Jump function".) If no line information exists at the jump destination address, however, you cannot jump. Opens the Source Window. If an active Source Window is open, that window is displayed in the forefront (so that it can be manipulated). Displays the memory contents starting from the jump destination address specified by the data value at the cursor position. (Refer to "5.12.2 Jump function".) Opens the Memory Window. If an active Memory Window is open, that window is displayed in the forefront (so that it can be manipulated). Cannot be selected. Come Here Change PC Break Point Software Break Point Source Text Memory Coverage Function buttons Search... Opens the Assemble Search Dialog Box and searches for a character string of mnemonics. Specify a search method in the Assemble Search Dialog Box. The results of search is highlighted in the Assemble Window. This is the same operation as selecting [View] menu -> [Search...]. Searches forward (upward on screen) for the contents that satisfy the search condition set in the Assemble Search Dialog Box, starting from the address at the cursor position. This button is displayed as the << >> Stop(during a search) Watch Quick... User's Manual U17287EJ1V0UM 121 CHAPTER 6 WINDOW REFERENCE Refresh Close Updates the contents of the window with the latest data. Closes this window. Related operations (1) Online assembly To change the disassembled contents, move the cursor to the mnemonic field (the overwrite and insertion modes are alternately selected by pressing the Insert key). If an attempt is made to move the cursor to another line after the disassembled contents have been changed in the mnemonic field, the new contents are checked. If the new contents are illegal, the code data on the line where the contents have been changed is indicated as "*". The contents changed in the mnemonic field are written into the memory by pressing the Enter key. By pressing the Enter key, the new contents are checked. If even one line is illegal, the new contents are not written into the memory. To discard the contents, press the ESC key. If the contents are correct and if the Enter key is pressed, the contents are written to the memory, and then the cursor moves to the next line in the mnemonic field, so that the data on the next line can be changed. Caution If the number of new instruction bytes is less than the number of previous instruction bytes as a result of changing, as many 'nop' instructions as necessary are inserted. If the number of new instruction bytes is more than the number of previous instruction bytes, the next instruction is overwritten. In this case also, as many 'nop' instructions as necessary are inserted. that straddle over source lines. The same applies to instructions 122 User's Manual U17287EJ1V0UM CHAPTER 6 WINDOW REFERENCE Assemble Search Dialog Box This dialog box is used to search the contents in the Assemble Window. (Refer to "5.3.2 Disassemble display".) Successive character strings included in an input character string and disassembler character string are compared as one blank character. By setting each item and then clicking the - Opening - Explanation of each area - Function buttons Opening When the Assemble Window is the current window, select [View] menu -> [Search...], or click the Explanation of each area (1) Find What: (2) Match Case (3) Scan Whole Region (4) Direction (5) Address: User's Manual U17287EJ1V0UM 123 CHAPTER 6 WINDOW REFERENCE (1) Find What: This area is used to specify the data to be searched. (Up to 256 character.) In the default condition, the string selected in the window that called this dialog box is displayed. As necessary, the character string displayed can be changed. Up to 16 input histories can be recorded. (2) Match Case This should be checked to distinguish between uppercase and lowercase. (3) Scan Whole Region This should be checked to search the entire specified range. (4) Direction This area is used to specify the direction of the search. Up Down Forward search. Searches data forward (upward on screen) from the current position of the cursor. Backward search. Searches data backward (downward on screen) from the current position of the cursor (default). (5) Address: This area is used to specify the address to be searched. The default radix for inputting a numeric value is hexadecimal. An address can be also specified by a symbol or expression. (Refer to "Table 5-5 Specifying Symbols".) Function buttons Find Next Searches the specified data in accordance with a given condition. If the specified character string is found as a result of a search, it is highlighted. To continue searching, click this button again. Sets the specified condition as the search condition and closes this dialog box. Stops searching. Closes this dialog box. (During searching, this button is replaced by the Set Find Stop (searching) Cancel Help 124 User's Manual U17287EJ1V0UM CHAPTER 6 WINDOW REFERENCE Address Move Dialog Box This dialog box is used to specify the start address from which displaying, as follows. - Memory Window - Assemble Window - SFR Window Figure 6-20 Address Move Dialog Box (Example: When Memory Window Is Open) - Opening - Explanation of each area - Function buttons Opening When the target window is the current window, select [View] menu -> [Move...]. Explanation of each area (1) To: This area is used to specify an address. In the default condition, the string selected in the window that called this dialog box, or the current PC value etc. is displayed. As necessary, the character string displayed can be changed. The default radix for inputting a numeric value is hexadecimal. An address can be also specified by a symbol or expression. (Refer to "Table 5-5 Specifying Symbols".) Up to 16 input histories can be recorded. Function buttons OK Cancel Restore Help The corresponding window is displayed from the address. Closes this dialog box. Restores the status before this dialog box was opened. Displays this dialog box online help files. User's Manual U17287EJ1V0UM 125 CHAPTER 6 WINDOW REFERENCE Symbol To Address Dialog Box This dialog box is used to display the address of the specified variable or function, or the value of the specified symbol. (Refer to "5.3 Source Display, Disassemble Display Function".) Figure 6-21 Symbol To Address Dialog Box - Opening - Explanation of each area - Function buttons Opening Select [View] menu -> [Symbol...]. Explanation of each area (1) Symbol: (2) Conversion result display area (3) Radix: 126 User's Manual U17287EJ1V0UM CHAPTER 6 WINDOW REFERENCE (1) Symbol: This area is used to specify the variable, function name, symbol name, or line number to be converted. (Refer to "Table 5-5 Specifying Symbols".) The default radix for inputting a numeric value is decimal. Up to 16 input histories can be recorded. To change the contents of this area, click the Function buttons OK If the contents of (1) Symbol: have been changed, converts the symbol. After conversion, closes the dialog box if the contents of (1) Symbol: have not been changed. Closes this dialog box. Restores the input data to the original status. If the Cancel Restore Help User's Manual U17287EJ1V0UM 127 CHAPTER 6 WINDOW REFERENCE Watch Window This window is used to display and change specified watch data. (Refer to "5.6 Watch Function".) This window can also display wide-ranging watch data (such as global variables and public symbols) in real time even during program execution, in the same way as the Memory Window. The results of updating and rewriting data in this window will be reflected in the Memory Window. Watch data is registered by clicking the - Opening - Explanation of each area - [View] menu (Watch Window-dedicated items) - Context menu - Function buttons Opening Click the Wch button, or select [Browse] menu -> [Watch]. Explanation of each area (1) Left field (symbol name display area) (2) Right field (data value display/setting area) 128 User's Manual U17287EJ1V0UM CHAPTER 6 WINDOW REFERENCE (1) Left field (symbol name display area) This area is used to display variable names, symbol names and types, and tag names of structures or unions. '+' is prefixed to the displayed arrays, pointer variables, and structures or unions. These variables are expanded and displayed as follows when they are double-clicked: Table 6-6 Watch Window Display Format (Symbol) First character + Meaning Array, pointer variable, or structure/union Expanded display is performed by double-clicking "+" (first character changes from "+" to "-"). Array Pointer variable Structure/union By double-clicking the "+", all the elements of the variable are displayed in accordance with the type of the array variable. By double-clicking the "+", the data indicated by the pointer is displayed. By double-clicking the "+", all the members of the structure/union are displayed in accordance with the type of the member variable. If a structure or union is defined in the structure or union, the structure name or union name of the internal structure or union is also displayed. The internal structure or union can be also expanded by using "+". - Expanded display variable Expanded display is canceled by double-clicking "-" (first character changes from "-" to "+"). Remark If an array has too many variables and takes too long to expand, a warning message is displayed. Registered watch data changes are performed in the Change Watch Dialog Box opened by selecting the item to be changed and then selecting Context menu -> [Change Watch...]. A line with an expanded hierarchy, such as the elements of an array, and members of structures and unions cannot be deleted. If an access breakpoint is set for a variable or a symbol in the Watch Window, the symbol name display area is highlighted in gold. (2) Right field (data value display/setting area) This area is used to display and change watch data values. A value is updated when execution is stopped. To save a value, select [File ] menu -> [Save As...]. This area is blank if getting data has failed. Values are changed through direct input. The location to be changed is displayed in red and the contents of the change are written into the target memory when the Enter key is pressed. The previous value can be canceled by the ESC key. User's Manual U17287EJ1V0UM 129 CHAPTER 6 WINDOW REFERENCE The display format is as follows: Table 6-7 Watch Window Display Format (Data) Display Data Integer Hexadecimal (0xxxxx) or (xxxxH) Decimal (xxxx) or (xxxxT) Octal (0xxxx) or (xxxxQ) Binary (0bxxxx) or (xxxxY) "Character" Member name Displayed in accordance with specified scope. Single precision/double precision supported The input/display format is as follows: [ + | - ] inf [ + | - ] nan [ + | - ] integer e [ + | - ]exponent [ + | - ] integer.fraction[ e [ + | - ]exponent Data that has been invalidated because of a change in the scope or optimized compiling Contents Character Enumeration type If scope is specified Floating-point type "?" Remark The radix of a data value can be changed on the Context menu for each variable. The display format of "integer" can be changed on the Debugger Option Dialog Box. [View] menu (Watch Window-dedicated items) When this window is the current window, The following items are added on [View] menu. Only the selected item is subject to this manipulation. Create Break Event Beak when Access to this Variable Break when Write to this Variable Break when Read from this Variable Clear Event? Bin Oct Creates a break event by using the selected item as follows. Creates a break event that can be accessed for read/write. Creates a break event that can be accessed for write. Creates a break event that can be accessed for read. Deletes a break event corresponding to the selected item. Displays the event information of the variable selected. If an event is set, the Event Dialog Box is opened. Displays binary numbers. Displays octal numbers. 130 User's Manual U17287EJ1V0UM CHAPTER 6 WINDOW REFERENCE Dec Hex String Proper Displays decimal numbers. Displays hexadecimal numbers. Displays character strings. Displays the default value of each variable . Symbols are displayed in accordance with the setting of the Debugger Option Dialog Box (default). Displays in 8-bit units. Displays in 16-bit units. Displays in 32-bit units. Displays the default value of each variable (default). Only this item is valid for a symbol in C language. Symbols in assembly language are displayed in accordance with the setting of the Debugger Option Dialog Box . Moves up one line. Moves down one line. Forcibly reads SFR that are disabled from being read because their values will be changed, or the data of the I/O ports and I/O protect area added in the Add I/ O Port Dialog Box. Byte Word Double Word Adaptive Up Down Compulsion Read Context menu The menu items are effective for the selected line or item, not the position where the mouse pointer was clicked (same operation as when selecting the main menu with the same name). Beak when Access to this Variable Break when Write to this Variable Break when Read from this Variable Clear RRM Setting... Event? Change Watch... Delete Watch Bin Oct Dec Creates a break event that can be accessed for read/write by using the selected item. Creates a break event that can be accessed for write by using the selected item. Creates a break event that can be accessed for read by using the selected item. Deletes a break event corresponding to the selected item. Sets the sampling range of the RRM function). Opens the RRM Dialog Box. Displays the event information of the variable selected. If an event is set, the Event Dialog Box is opened. Changes the selected watch data. Opens the Change Watch Dialog Box. Deletes the selected watch data from the window. Displays the selected line in binary numbers. Displays the selected line in octal numbers. Displays the selected line in decimal numbers. User's Manual U17287EJ1V0UM 131 CHAPTER 6 WINDOW REFERENCE Hex String Proper Displays the selected line in hexadecimal numbers. Displays the selected line as a character string. Displays the selected line as the default value of each variable . Symbols are displayed in accordance with the setting of the Debugger Option Dialog Box (default). Displays the selected line in 8-bit units. Displays the selected line in 16-bit units. Displays the selected line in 32-bit units. Displays the selected line as the default value of each variable (default). Only this item is valid for a symbol in C language. Symbols in assembly language are displayed in accordance with the setting of the Debugger Option Dialog Box . Moves the selected line one line up. Moves the selected line one line down. Byte Word Double Word Adaptive Up Down Function buttons Add... Opens the Add Watch Dialog Box. If watch data is specified and the Delete Up Down Refresh Close 132 User's Manual U17287EJ1V0UM CHAPTER 6 WINDOW REFERENCE Quick Watch Dialog Box This dialog box is used to temporarily display or change specified watch data. (Refer to "5.6 Watch Function".) Figure 6-23 Quick Watch Dialog Box - Opening - Explanation of each area - Function buttons Opening When the Source Window or the Assemble Window is the current window, select [View] menu -> [Quick Watch...], or click the Explanation of each area (1) Name: (2) Symbol name display area (3) Data value display/setting area (4) Display radix selection area (upper left field) (5) Display size selection area (second upper left field) (6) Number: User's Manual U17287EJ1V0UM 133 CHAPTER 6 WINDOW REFERENCE (1) Name: This area is used to specify the watch data to be displayed. In the default condition, the string selected in the window that called this dialog box is displayed. As necessary, the character string displayed can be changed. Up to 16 input histories can be recorded. If the contents of this area have been changed, the data specified can be displayed in the field below by clicking the (5) Display size selection area (second upper left field) This area is used to select the display size. If the display size is fixed, such as when a variable in C language or register is to be displayed, it cannot be changed. Adaptive Byte Word Double Word Variable: Displays the default value of each variable. Symbol: Displays data with the size set in the Debugger Option Dialog Box. Displays in 8-bit units. Displays in 16-bit units. Displays in 32-bit units. 134 User's Manual U17287EJ1V0UM CHAPTER 6 WINDOW REFERENCE (6) Number: This area is used to specify the number of data to be displayed (blank or a number of 1 to 256). If this area is blank, data is displayed as a simple variable. If a number of 1 or more is specified, data is displayed as an array variable in the Watch Window. If an array variable is displayed, "+" is prefixed to the data. By double-clicking this "+", all the elements of the data are expanded and displayed in accordance with the type of the data ( "-" is prefixed to the expanded data. If this "-" is double-clicked, the expanded display is canceled). If the number of data to be displayed is fixed, such as when a variable in C language or register is to be displayed, the specified number of data is invalid. Function buttons View Add Close Displays the data specified in (1) Name: in the field below. Adds the data specified in (1) Name: to the Watch Window. Closes this dialog box. Data that has not actually been written to the target memory will be canceled. User's Manual U17287EJ1V0UM 135 CHAPTER 6 WINDOW REFERENCE Add Watch Dialog Box This dialog box is used to register watch data to be displayed in the Watch Window. (Refer to "5.6 Watch Function".) Multiple data with the same symbol name can be registered. Figure 6-24 Add Watch Dialog Box - Opening - Explanation of each area - Function buttons Opening Select [View] menu -> [Add Watch...], or click the Explanation of each area (1) Name: (2) Radix: (3) Size: (4) Number: 136 User's Manual U17287EJ1V0UM CHAPTER 6 WINDOW REFERENCE (1) Name: This area is used to specify symbol to be added to the Watch Window. In the default condition, the string selected in the window that called this dialog box is displayed. As necessary, the character string displayed can be changed. This area is blank if no character string is selected. Up to 16 input histories can be recorded. The input format is as follows: Table 6-8 Watch Window Input Format - Variable Name of C language Variable expression : Variable Name |Variable expression [Constant value | Variable Name] |Variable expression . Member name |Variable expression -> Member name |*Variable expression |&Variable expression - Register name - SFR name, SFR bit name - Label, EQU and address of immediate value - Register name.bit - SFR name. bit - Label name.bit , EQU symbol.bit, address of immediate value.bit - Bit symbol - Specification of scope Elements of array Entity members of structure/union Members of structure/union indicated by pointer Value of pointer variable Address where variable is located How a variable is handled when a scope Is specified is as follows: Table 6-9 How a Variable Is Handled When a Scope Is Specified Scope Specification prog$file#func#var prog$file#var prog$func#var prog$var file#func#var file#var Program name prog prog prog prog current current file file global global file file File name Function name func global func global func global Variable Name var var var var var var User's Manual U17287EJ1V0UM 137 CHAPTER 6 WINDOW REFERENCE Scope Specification func#var var (2) Radix: Program name current current File name current current Function name func current Variable Name var var This area is used to select the display radix. (Refer to "(4) Display radix selection area (upper left field)" in the Quick Watch Dialog Box.) (3) Size: This area is used to select the display size. (Refer to "(5) Display size selection area (second upper left field)" in the Quick Watch Dialog Box.) (4) Number: This area is used to specify the number of data to be displayed. (Refer to "(6) Number:" in the Quick Watch Dialog Box.) Function buttons Add OK Cancel Restore Help Adds the specified data to the Watch Window. The dialog box remains open. Adds the specified data to the Watch Window. Closes this dialog box. Closes this dialog box. Restores the status before this dialog box was opened. Displays this dialog box online help files. 138 User's Manual U17287EJ1V0UM CHAPTER 6 WINDOW REFERENCE Change Watch Dialog Box This window is used to change the data on a line selected in the Watch Window. (Refer to "5.6 Watch Function".) A line with an open hierarchy, such as the elements of an array, and members of structures and unions cannot be changed. When watch data is changed, the contents of the selected line are replaced with the new data. The symbol name can be changed even if it results in duplication of a name already in use with existing data. Figure 6-25 Change Watch Dialog Box - Opening - Explanation of each area - Function buttons Opening When the Watch Window is the current window, select [View] menu -> [Change Watch...]. Explanation of each area (1) Name: (2) Radix: (3) Size: (4) Number: User's Manual U17287EJ1V0UM 139 CHAPTER 6 WINDOW REFERENCE (1) Name: This area is used to change a symbol name on a line selected in the Watch Window. (Refer to "(1) Name:" in the Add Watch Dialog Box.) (2) Radix: This area is used to change the display radix on a line selected in the Watch Window . (Refer to "(4) Display radix selection area (upper left field)" in the Quick Watch Dialog Box.) (3) Size: This area is used to change the display size on a line selected in the Watch Window. (Refer to "(5) Display size selection area (second upper left field)" in the Quick Watch Dialog Box.) (4) Number: This area is used to change the number of data to be displayed on a line selected in the Watch Window. (Refer to "(6) Number:" in the Quick Watch Dialog Box.) Function buttons Add OK Cancel Restore Help Cannot be selected. Replaces the data on a line selected in the Watch Window with the specified data, and then closes this dialog box. Closes this dialog box. Restores the status before this dialog box was opened. Displays this dialog box online help files. 140 User's Manual U17287EJ1V0UM CHAPTER 6 WINDOW REFERENCE Local Variable Window This window is used to display the local variable in the current function and change the local variable values. (Refer to "5.6 Watch Function".) It is linked with the Jump function of the Stack Window, and displays the local variable in the function jumped when jumping to the Source Window. A number of other operations using Context menu, Function buttons, etc., can be performed in this window. Figure 6-26 Local Variable Window - Opening - Explanation of each area - Context menu - Function buttons Opening Click the Loc button, or select [Browse] menu -> [Local Variable]. Explanation of each area (1) Left field (local variable name display area) (2) Right field (local variable value display/setting area) User's Manual U17287EJ1V0UM 141 CHAPTER 6 WINDOW REFERENCE (1) Left field (local variable name display area) This area displays local variable name. (Refer to "(1) Left field (symbol name display area)" in the Watch Window.) Auto, Internal Static, and Register variables can be displayed. This area cannot be edited. (2) Right field (local variable value display/setting area) This area is used to display and change local variable values. (Refer to "(2) Right field (data value display/setting area)" in the Watch Window.) [View] menu (Local Variable Window-dedicated items) When this window is the current window, the following items are added on [View] menu. Bin Oct Dec Hex String Proper Displays binary numbers. Displays octal numbers. Displays decimal numbers. Displays octal numbers. Displays character strings. Displays the default value of each variable (default). Context menu The menu items are effective for the selected line or item, not the position where the mouse pointer was clicked (same operation as when selecting the main menu with the same name). Add Watch... Bin Oct Dec Hex String Proper Opens the Add Watch Dialog Box. Displays the selected line in binary numbers. Displays the selected line in octal numbers. Displays the selected line in decimal numbers. Displays the selected line in hexadecimal numbers. Displays the selected line as a character string. Displays the selected line as the default value of each variable . Symbols are displayed in accordance with the setting of the Debugger Option Dialog Box (default). Function buttons Refresh Close Updates the contents of this window with the latest watch data. Closes this window. 142 User's Manual U17287EJ1V0UM CHAPTER 6 WINDOW REFERENCE Stack Window This window is used to display or change the current stack contents of the user program. (Refer to "5.6.7 Stack trace display function".) The window corresponding to the stack contents can be jumped to using the Jump function. A number of other operations using Context menu, Function buttons, etc., can be performed in this window. Caution The stack trace display function may not operate properly when there is a function (noauto, norec, etc.) that does not push the frame pointer (HL) onto the stack, or when the -qf option is provided as an optimization option during compiling. Remark [ERROR] may be displayed during prologue or epilogue processing of a function. Figure 6-27 Stack Window - Opening - Explanation of each area - [View] menu (Stack Window-dedicated items) - Context menu - Function buttons Opening Click the Stk button, or select [Browse] menu -> [Stack Trace]. Explanation of each area (1) Left field (stack frame number display area) (2) Center field (stack frame contents display area) (3) Right field (stack contents display/setting area) User's Manual U17287EJ1V0UM 143 CHAPTER 6 WINDOW REFERENCE (1) Left field (stack frame number display area) This area assigns numbers to and displays the stack contents. A stack frame number is a natural number starting from 1. The shallower the nesting of the stack, the higher the number. This means that a function having stack number one higher than that of a certain function is the function that calls the certain function. (2) Center field (stack frame contents display area) This area displays the stack frame contents. It displays function names or local variable names. Note, however, that this area cannot be edited. (a) If the stack contents consist of a function They are displayed as follows: [program name$file name#function name (argument list) #line number] If this line is double-clicked, the operation will be the same as jumping to the Source Window of the Jump function (i.e., the local variable in the function to which execution has jumped will be displayed in the Local Variable Window).If the function has a local variable, the local variable will be displayed on the next and subsequent lines. (b) If the stack contents consist of a local variable Its type and name are displayed. (Refer to "Table 6-6 Watch Window Display Format (Symbol)".) Note that the internal Static and Register variables are not displayed. (3) Right field (stack contents display/setting area) This area is used to display or change the stack contents. (a) If the stack contents are a function "--" is displayed and the function cannot be changed. (b) If the stack contents are a local variable The variable value is displayed. (Refer to "Table 6-7 Watch Window Display Format (Data)".) [View] menu (Stack Window-dedicated items) When this window is the current window, The following items are added on [View] menu. Bin Oct Dec Hex String Proper Displays binary numbers. Displays octal numbers. Displays decimal numbers. Displays octal numbers. Displays character strings. Displays the default value of each variable (default). 144 User's Manual U17287EJ1V0UM CHAPTER 6 WINDOW REFERENCE Context menu Bin Oct Dec Hex String Proper Displays the selected line in binary numbers. Displays the selected line in octal numbers. Displays the selected line in decimal numbers. Displays the selected line in hexadecimal numbers. Displays the selected line as a character string. Displays the selected line as the default value of each variable . Symbols are displayed in accordance with the setting of the Debugger Option Dialog Box (default). Displays the corresponding source text and source line from the jump destination address specified by the data value at the cursor position. (Refer to "5.12.2 Jump function".) If no line information exists at the jump destination address, however, you cannot jump. Opens the Source Window. If an active Source Window is open, that window is displayed in the forefront (so that it can be manipulated). Disassembles and displays starting from the jump destination address specified by the data value at the cursor position. (Refer to "5.12.2 Jump function".) Opens the Assemble Window. If an active Assemble Window is open, that window is displayed in the forefront (so that it can be manipulated). Displays the memory contents starting from the jump destination address specified by the data value at the cursor position. (Refer to "5.12.2 Jump function".) Opens the Memory Window. If an active Memory Window is open, that window is displayed in the forefront (so that it can be manipulated). Cannot be selected. Source Text Assemble Memory Coverage Function buttons Refresh Shrink <<< Expand >>> (when the Updates the contents of this window with the latest watch data. Collapses the local variable list of the selected function. Displays the local variable list of the selected function. Closes this window. User's Manual U17287EJ1V0UM 145 CHAPTER 6 WINDOW REFERENCE Memory Window This window is used to display and change the memory contents. (Refer to "5.7 Memory Manipulation Function".) Other operations using Context menu, Function buttons, etc., can be performed in this window. Moreover, there are two statuses, Active status and static status, for this window. When the window is in the active status, it has the Jump function. (Refer to "5.12 Functions Common to Each Window".) Remark The display start position when the this window is opened is as follows: First time: Display starts from the first address of the RAM area. Second and subsequent times: Display starts from the address at which an active status window was closed. (if an active status window has never been closed, display starts from the first display start position). Figure 6-28 Memory Window - Opening - Explanation of each area - [View] menu (Memory Window-dedicated items) - Context menu - Function buttons Opening Click the Mem button, or select [Browse] menu -> [Memory]. 146 User's Manual U17287EJ1V0UM CHAPTER 6 WINDOW REFERENCE Explanation of each area (1) Addr (2) +0 +1 +2.... (3) 0 1 2 3.... (1) Addr This area displays memory addresses. (2) +0 +1 +2.... This area is used to display and change memory contents. Values are changed through direct input. The location to be changed is displayed in red and the contents of the contents of the change are written into the target memory when the Enter key is pressed. The previous value can be canceled by the ESC key. Up to 256 bytes can be specified at one time. (3) 0 1 2 3.... This area is used to display and change the memory contents in ASCII characters. This area is displayed when [View] menu -> [Ascii] is selected. Data can be changed in this area in the same manner as in the memory display area. The changing method is the same as in (2) +0 +1 +2..... [View] menu (Memory Window-dedicated items) The following items are added in the [View] menu , when the Memory Window is active. Bin Oct Dec Hex Nibble Byte Word Double Word Ascii Displays binary numbers. Displays octal numbers. Displays decimal numbers. Displays hexadecimal numbers (default). Displays in 4-bit units. Displays in 8-bit units (default). Displays in 16-bit units. Displays in 32-bit units. Selects whether ASCII characters are displayed or not. Checked: Displayed Not checked: No display (default) Displays in little endian (default). Displays in big endian. Cannot be selected. Little Endian Big Endian Access Monitoring User's Manual U17287EJ1V0UM 147 CHAPTER 6 WINDOW REFERENCE Context menu The menu items are effective for the selected line or item, not the position where the mouse pointer was clicked (same operation as when selecting the main menu with the same name). Move... Bin Oct Dec Hex Nibble Byte Word Double Word Ascii Moves the display position. Opens the Address Move Dialog Box. Displays binary numbers. Displays octal numbers. Displays decimal numbers. Displays hexadecimal numbers (default). Displays in 4-bit units. Displays in 8-bit units (default). Displays in 16-bit units. Displays in 32-bit units. Selects whether ASCII characters are displayed or not. Checked: Displayed Not checked: No display (default) Cannot be selected. Cannot be selected. Clear Access Monitor Accumulative Function buttons Search... Opens the Memory Search Dialog Box and searches for character strings from the displayed memory contents, or memory contents. Selected data (a memory value) is displayed in the Memory Search Dialog Box as data to be searched.If the Memory Search Dialog Box is opened without data specified, specify data from the keyboard. The results of the search is highlighted in the Memory Window. Searches the memory contents satisfying the search condition set in the Memory Search Dialog Box, forward (upward on screen) from the address at the cursor position. This button is displayed as the << >> Stop(searching) Refresh Modify... Close 148 User's Manual U17287EJ1V0UM CHAPTER 6 WINDOW REFERENCE Memory Search Dialog Box This dialog box is used to search the memory contents of the part of the Memory Window at which the cursor is located. (Refer to "5.7 Memory Manipulation Function".) If the cursor is placed in (2) +0 +1 +2.... in the Memory Window, the specified data is treated as a binary data string, and if the cursor is placed in (3) 0 1 2 3...., the specified data is treated as an ASCII character string, and the contents of these respective areas are searched. By setting each item and then clicking the - Opening - Explanation of each area - Function buttons Opening When the Memory Window is the current window, select [View] menu -> [Search...], or click the Explanation of each area (1) Find What: (2) Unit: (3) Scan Whole Region (4) Direction (5) Address: User's Manual U17287EJ1V0UM 149 CHAPTER 6 WINDOW REFERENCE (1) Find What: This area is used to specify the data to be searched. In the default condition, the string selected in the window that called this dialog box is displayed. As necessary, the character string displayed can be changed. Up to 16 input histories can be recorded. (a) When searching in (2) +0 +1 +2.... Up to 16 data items can be specified. Delimit each data with a "blank character". (b) When searching in (3) 0 1 2 3.... Up to 256 characters can be specified. A "blank character" in the data is treated as a blank character. (2) Unit: This area is used to specify the number of bits of the data to be searched in (2) +0 +1 +2..... Byte Word Double Word Searches the data as 8-bit data (default). Searches the data as 16-bit data. Searches the data as 32-bit data. (3) Scan Whole Region This should be checked to search the entire specified range. (4) Direction This area is used to specify the direction of the search. Up Down Forward search. Searches data forward (upward on screen) from the current position of the cursor. Backward search. Searches data backward (downward on screen) from the current position of the cursor (default). (5) Address: This area is used to specify the address to be searched. The default radix for inputting a numeric value is hexadecimal. An address can be also specified by a symbol or expression. (Refer to "Table 5-5 Specifying Symbols".) Function buttons Find Next Searches the specified data in accordance with a given condition. If the specified character string is found as a result of a search, it is highlighted. To continue searching, click this button again. Sets the specified condition as the search condition and closes this dialog box. Stops searching. Closes this dialog box.(During searching, this button is replaced by the Set Find Stop (searching) Cancel Help 150 User's Manual U17287EJ1V0UM CHAPTER 6 WINDOW REFERENCE Memory Fill Dialog Box This dialog box is used to fill the memory contents in the Memory Window with specified codes (fill code). (Refer to "5.7 Memory Manipulation Function".) Figure 6-30 Memory Fill Dialog Box - Opening - Explanation of each area - Function buttons Opening Select [Edit] menu -> [Memory] -> [Fill...]. Explanation of each area (1) Address (2) fill code => User's Manual U17287EJ1V0UM 151 CHAPTER 6 WINDOW REFERENCE (1) Address This area is used to specify the memory address range whose contents are filled. The default radix for inputting a numeric value is hexadecimal. An address can be also specified by a symbol or expression. (Refer to "Table 5-5 Specifying Symbols".) (2) fill code => This area is used to specify the data (fill code) used when filling the range specified in (1) Address. Up to 16 binary data strings (byte data strings) can be specified. Delimit each data with a "blank character". Function buttons OK Stop (filling) Cancel Restore Help Fills the specified data in accordance with a given condition. Stops filling. Closes this dialog box. (During filling, this button is replaced by the 152 User's Manual U17287EJ1V0UM CHAPTER 6 WINDOW REFERENCE Memory Copy Dialog Box This dialog box is used to copy the memory contents in the Memory Window. (Refer to "5.7 Memory Manipulation Function".) Figure 6-31 Memory Copy Dialog Box - Opening - Explanation of each area - Function buttons Opening Select [Edit] menu -> [Memory] -> [Copy...]. Explanation of each area (1) Address This area is used to specify the copy source and copy destination addresses. The default radix for inputting a numeric value is hexadecimal. An address can be also specified by a symbol or expression. (Refer to "Table 5-5 Specifying Symbols".) (a) From: Specify the address range (start address -- end address) of the copy source. (b) To: Specify start address of the copy destination. User's Manual U17287EJ1V0UM 153 CHAPTER 6 WINDOW REFERENCE Function buttons OK Stop (copying) Cancel Restore Help Copies the memory contents in accordance with a given condition. Stops copying. Closes this dialog box. (During copying, this button is replaced by the 154 User's Manual U17287EJ1V0UM CHAPTER 6 WINDOW REFERENCE Memory Compare Dialog Box This dialog box is used to compare the memory contents in the Memory Window. (Refer to "5.7 Memory Manipulation Function".) Figure 6-32 Memory Compare Dialog Box - Opening - Explanation of each area - Function buttons Opening Select [Edit] menu -> [Memory] -> [Compare...]. Explanation of each area (1) Address This area is used to specify the comparison source address and comparison destination address. The default radix for inputting a numeric value is hexadecimal. An address can be also specified by a symbol or expression. (Refer to "Table 5-5 Specifying Symbols".) (a) Mem1: Specify the address range (start address -- end address) of the comparison source. (b) Mem2: Specify the start address of the comparison destination. User's Manual U17287EJ1V0UM 155 CHAPTER 6 WINDOW REFERENCE Function buttons OK Compares the memory contents in accordance with a given condition. If no difference is found as a result of comparison, " Wf200: No difference encountered." is displayed. If a difference is found, the Memory Compare Result Dialog Box is opened. Stops memory comparison. Closes this dialog box. (During comparison, this button is replaced by the Stop (comparison) Cancel Restore Help 156 User's Manual U17287EJ1V0UM CHAPTER 6 WINDOW REFERENCE Memory Compare Result Dialog Box This dialog box is displayed if any difference is found in the memory contents when the memory has been compared in the Memory Compare Dialog Box .(Refer to "5.7 Memory Manipulation Function".) Figure 6-33 Memory Compare Result Dialog Box - Explanation of each area - Function buttons Explanation of each area (1) (comparison result display area) This area displays the results of comparing the memory. Only differences that have been found as a result of comparison are displayed. (a) Mem1 Addr Displays a comparison source address in which a difference has been found. (b) Memory Displays the data in which a difference has been found (Left: Comparison source data, Right: Comparison destination data ). (c) Mem2 Addr Displays the comparison destination address at which a difference has been found. Function buttons Close Help Closes this dialog box. Displays this dialog box online help files. User's Manual U17287EJ1V0UM 157 CHAPTER 6 WINDOW REFERENCE Register Window This window is used to display and change registers (general-purpose registers/control registers). (Refer to "5.8 Register Manipulation Function".) Other operations using Context menu, Function buttons, etc., can be performed in this window. Each area in this window are the jump pointer of the Jump function. Figure 6-34 Register Window - Opening - Explanation of each area - [View]menu (Register Window-dedicated items) - Context menu - Function buttons Opening Click the Reg button, or select [Browse] menu -> [Register]. 158 User's Manual U17287EJ1V0UM CHAPTER 6 WINDOW REFERENCE Explanation of each area (1) Upper field (general-purpose registers display area) (2) Lower field (control registers display area) (1) Upper field (general-purpose registers display area) This area is used to display and change the general-purpose registers. Register values are changed through direct input. The location to be changed is displayed in red and the contents of the contents of the change are written into the target memory when the Enter key is pressed. The previous value can be canceled by the ESC key. (2) Lower field (control registers display area) This area is used to display and change the control registers. By double-clicking "+", flag name and flag value are displayed (first character changes from "+" to "-"). Expanded display is canceled by double-clicking "-" (first character changes from "-" to "+"). Register values are changed through direct input. The location to be changed is displayed in red and the contents of the contents of the change are written into the target memory when the Enter key is pressed. The previous value can be canceled by the ESC key. [View]menu (Register Window-dedicated items) The following items are added in the [View] menu , when the Register Window is active. Bin Oct Dec Hex Absolute Name Function Name Displays binary numbers. Displays octal numbers. Displays decimal numbers. Displays hexadecimal numbers (default). Displays register names as absolute names. Displays register names as function names (default). Context menu Add Watch... Bin Oct Dec Hex Registers a selected character string to the Watch Window. Opens the Add Watch Dialog Box. Displays the selected line in binary numbers. Displays the selected line in binary numbers. Displays the selected line in decimal numbers. Displays the selected line in hexadecimal numbers (default). User's Manual U17287EJ1V0UM 159 CHAPTER 6 WINDOW REFERENCE Function buttons Refresh Modify... Close Updates the contents of the window with the latest data. Cannot be selected. Closes this window. 160 User's Manual U17287EJ1V0UM CHAPTER 6 WINDOW REFERENCE SFR Window This window is used to display and change the contents of SFR and the I/O ports that have been registered in the Add I/O Port Dialog Box. (Refer to "5.8 Register Manipulation Function".) A number of other operations using Context menu, Function buttons, etc., can be performed in this window. Caution However, that the values of read-only SFR and I/O ports cannot be changed. In addition, the SFR and I/O ports that cause the device to operate when they are read are read-protected and therefore cannot be read. To read these registers, select a register, and select and execute [Compulsion Read] from the Context menu. Remark The display start position when the window is opened is as follows. First time: Display from SFR of minimum address Second and subsequent times: Display from first SFR when window was last closed Figure 6-35 SFR Window - Opening - Explanation of each area - [View] menu (SFR Window-dedicated items) - Context menu - Function buttons Opening Click the SFR button, or select [Browse] menu -> [SFR]. User's Manual U17287EJ1V0UM 161 CHAPTER 6 WINDOW REFERENCE Explanation of each area (1) Name (2) Attribute (3) Value (1) Name This area displays the names of SFR and I/O ports. If the value of an I/O port address is not defined, the I/O port name displayed in light color. (2) Attribute This area displays the attributes of SFR and I/O ports. This area displays the read/write attributes, access types, and displays and absolute addresses from the left side. When the bit SFR is displayed, bit-offset value is also displayed. It can be specified whether this area is displayed or not, by selecting [View] menu -> [Attribute]. Read/Write Attribute R W R/W * Read only Write only Read/write Register that is read via an emulation register to prevent the device from operating when this register is read. To read this attribute directly from a SFR, execute [View] menu -> [Compulsion Read]. Even a write-only SFR can also be read via an emulation register. However, some devices do not support this function. Access Type 1 8 16 32 Can be accessed in Bit units. Can be accessed in Byte units. Can be accessed in Word units. Can be accessed in Double Word units. 162 User's Manual U17287EJ1V0UM CHAPTER 6 WINDOW REFERENCE (3) Value This area is used to display and change the contents of a SFR and I/O port. The contents are displayed differently as follows, depending on the attribute: Black Display -** Read only or read/write Write only Value changes if read Values are changed through direct input. The location to be changed is displayed in red and the contents of the contents of the change are written into the target memory when the Enter key is pressed. The previous value can be canceled by the ESC key. Note that the values of read-only SFR and I/O ports cannot be changed. The value of read-protected SFR and I/O ports can be read by selecting Context menu -> [Compulsion Read]. [View] menu (SFR Window-dedicated items) When this window is the current window, the following items are added on [View] menu. Bin Oct Dec Hex Sort By Name Sort By Address Unsort Attribute Pick Up Select... Compulsion Read Displays binary numbers. Displays octal numbers. Displays decimal numbers. Displays octal numbers (default). Displays in alphabetical order. Displays in address order (default). Does not sort. Switches on/off display of (2) Attribute. Displays only the registers selected in the SFR Select Dialog Box. Opens the SFR Select Dialog Box. Forcibly reads the SFR that are disabled from being read because their values will be changed, or the data of the I/O ports and I/O protect area added in the Add I/O Port Dialog Box. User's Manual U17287EJ1V0UM 163 CHAPTER 6 WINDOW REFERENCE Context menu Move... Add Watch... Add I/O Port... Bin Oct Dec Hex Sort By Name Sort By Address Unsort Attribute Pick Up Select... Compulsion Read Opens the Address Move Dialog Box. Opens the Add Watch Dialog Box. Opens the Add I/O Port Dialog Box. Displays binary numbers. Displays octal numbers. Displays decimal numbers. Displays octal numbers (default). Displays in alphabetical order. Displays in address order (default). Does not sort. Switches on/off display of (2) Attribute. Displays only the registers selected in the SFR Select Dialog Box. Opens the SFR Select Dialog Box. Forcibly reads the SFR that are disabled from being read because their values will be changed, or the data of the I/O ports and I/O protect area added in the Add I/O Port Dialog Box. Function buttons Refresh Modify... Close Updates the contents of this window with the latest watch data. Cannot be selected. Closes this window. 164 User's Manual U17287EJ1V0UM CHAPTER 6 WINDOW REFERENCE SFR Select Dialog Box This dialog box is used to select SFR and I/O ports that are not displayed the SFR Window. (Refer to "5.8 Register Manipulation Function".) It is also used to specify the sequence in which registers and ports are displayed. Figure 6-36 SFR Select Dialog Box - Opening - Explanation of each area - Function buttons Opening When the SFR Window is the current window, select [View] menu -> [Select...]. Explanation of each area (1) Display, Pick Up, No Display (2) Arrange (3) Sort by User's Manual U17287EJ1V0UM 165 CHAPTER 6 WINDOW REFERENCE (1) Display, Pick Up, No Display This area is used to select SFR or I/O ports that are displayed in the SFR Window, and those that are not. (a) Display: The SFR or I/O ports displayed in the SFR Window. (b) No Display: The SFR or I/O ports not displayed in the SFR Window. (c) Pick Up The following buttons are used to change SFR or I/O ports to be displayed in the SFR Window. Two or more registers can be moved by clicking any of the above buttons while holding down the Ctrl or Shift key. << Show Hide >> << Show All Hide All >> Moves SFR or I/O ports selected from (b) No Display: list to (a) Display:. Moves SFR or I/O ports selected from (a) Display: list to (b) No Display:. Moves all SFR or I/O ports to (a) Display:. Moves all SFR or I/O ports to (b) No Display:. (2) Arrange The following buttons are used to change the display sequence in (a) Display:. Top Up Down Bottom Moves the selected SFR or I/O port to the top of the list. Moves the selected SFR or I/O port one line up. Moves the selected SFR or I/O port one line down. Moves the selected SFR or I/O port to the bottom of the list. (3) Sort by The following buttons are used to change the display sequence in (b) No Display:. Name Address Displays in alphabetical order. Displays in address order. Function buttons OK Cancel Restore Help Reflects the selection in this dialog box in the SFR Window and closes this dialog box. Cancels the changes and closes this dialog box. Restores the status before this dialog box was opened. Displays this dialog box online help files. 166 User's Manual U17287EJ1V0UM CHAPTER 6 WINDOW REFERENCE Add I/O Port Dialog Box This dialog box is used to register an I/O port to be added to the SFR Window. (Refer to "5.8 Register Manipulation Function".) Figure 6-37 Add I/O Port Dialog Box - Opening - Explanation of each area - Function buttons Opening Select [Option] menu -> [Add I/O Port...]. Explanation of each area (1) I/O Port List (2) Name: (3) Address: (4) Access (5) Read / Write User's Manual U17287EJ1V0UM 167 CHAPTER 6 WINDOW REFERENCE (1) I/O Port List This area lists the I/O ports currently registered. If a new I/O port is registered, it is added to this list. An I/O port already registered can be selected and changed or deleted by Function buttons. (2) Name: This area is used to specify an I/O port name to be added (up to 15 characters long). (3) Address: This area is used to specify the address of the I/O port to be added. The default radix for inputting a numeric value is hexadecimal. An address can be also specified by a symbol. (Refer to "Table 5-5 Specifying Symbols".) The address that can be set in this area is either a Target area address or SFR area address. (4) Access This area is used to select the access size of the I/O port to be added. Byte Word 8-bit unit (default) 16-bit unit (5) Read / Write This area is used to specify the access attribute of the I/O port to be added. In the default condition, all the attributes are not checked (i.e., the I/O port can be both read and written). Function buttons OK Cancel Restore Help Add Change Delete Reflects the results of addition in the SFR Window and closes this dialog box. Cancels the changing, closes this dialog box. Restores the original status. Displays this dialog box online help files. Adds an I/O port of the specified address. Changes the setting of the I/O port selected in (1) I/O Port List. Deletes the I/O port selected in (1) I/O Port List. 168 User's Manual U17287EJ1V0UM CHAPTER 6 WINDOW REFERENCE Software Break Manager This window is used to display, enable or disable, and delete software breaks . (Refer to "5.4.4 Hardware break and software break".) Software breakpoints cannot be set in this window; they can be set in the Source Window or the Assemble Window. (Refer to "5.4.2 Breakpoint setting".) Figure 6-38 Software Break Manager - Opening - Explanation of each area - Function buttons Opening Select [Event] menu -> [Software Break Manager]. Explanation of each area (1) Name (2) Brk (3) File#Line / Symbol+Offset (4) Address User's Manual U17287EJ1V0UM 169 CHAPTER 6 WINDOW REFERENCE (1) Name This area displays the names of registered events, and the check boxes that indicate whether each event is enabled or disabled. An event name is displayed in the form of "Swb+[number]" in the default condition. It can be changed to an alphanumeric string of up to 256 characters. To change an event name, select and click a name. Then directly edit the name. To set the editing, press the Enter key. When an event is enabled, the check box is checked. To be disable, the check box is not checked. Furthermore, the name jumps to the Source Window by double-clicking an event name if the event name corresponds to the source line, whereas the name jumps to the Assemble Window if it does not correspond to the source line. Remark By clicking "Name" (on the label), the character strings of the displayed items can be compared and sorted lexicographically (in alphabetical order). Whether the character strings are compared or sorted in ascending or descending order can be alternately selected by clicking the mouse. (2) Brk The ">" mark is displayed for a software break event that is set at the current PC position (so that the software break event that caused a break can be easily identified). (3) File#Line / Symbol+Offset This area displays the location at which a software break event was set as follows: - Program$file name#line number (If the event corresponds to the source line. ) - Program$file name#symbol+offset (If the event dose not correspond to the source line.) Events are evaluated based on this when a symbol is re-downloaded. Remark By clicking "File#Line/Symbol+Offset" (on the label), the character strings of the displayed items can be compared and sorted lexicographically (in alphabetical order). Whether the character strings are compared or sorted in ascending or descending order can be alternately selected by clicking the mouse. (4) Address This area displays the address at which a software break event is set. Remark By clicking "Address" (on the label), the numeric values of the displayed items can be compared and sorted. Whether the values are compared or sorted in ascending or descending order can be alternately selected by clicking the mouse. 170 User's Manual U17287EJ1V0UM CHAPTER 6 WINDOW REFERENCE Function buttons Enable Disable Delete Delete ALL Close Enables the selected event. Disables the selected event. Deletes the selected event. Deletes all the set software break events. Closes this window. User's Manual U17287EJ1V0UM 171 CHAPTER 6 WINDOW REFERENCE Event Manager This window is used to manage event conditions. This window allows display, enabling/disabling, and deletion of the Various Event Conditions. (Refer to "5.9 Event Function".) A number of other operations using Context menu, Function buttons (Related event function), etc., can be performed in this window. The event icon is the jump pointer of the Jump function. Figure 6-39 Event Manager (In Detailed Display Mode) - Opening - Explanation of each area - [View]menu (Event manager-dedicated items) - Context menu - Function buttons (Related event function) Opening Click the Mgr button, or select [Event] menu -> [Event Manager]. 172 User's Manual U17287EJ1V0UM CHAPTER 6 WINDOW REFERENCE Explanation of each area (1) Event display area This area displays the icons (event icons) of the registered Various Event Conditions. By selecting the context menu -> [Detail], the details can be displayed. (a) In list displayed Displays event icon (refer to "Table 5-12 Event Icon"). The event icon is the jump pointer (refer to "5.12.2 Jump function"). (b) In detailed display Details of event contents are displayed by using the following key information as a separator. Table 6-10 Separator for Displaying Event Details Key Information Event condition [S] [Z] [A] [D] [M] Break condition [B] Break condition Status condition Access size condition Address condition Symbol or expression: (actual address) Data condition Symbol or expression: (actual address) Mask condition Contents User's Manual U17287EJ1V0UM 173 CHAPTER 6 WINDOW REFERENCE [View]menu (Event manager-dedicated items) The following items are added in the [View] menu , when the Event Manager is active. Select All Event Delete Event Sort By Name Sort By Kind Unsort Detail Overview Selects all the registered events. Deletes a selected event. Displays icons in the order of event names. Displays icons in the order of event types. Does not sort icons (default). Displays the details List display (default) Context menu Sort By Name Sort By Kind Unsort Detail Overview Source Text Displays icons in the order of event names. Displays icons in the order of event types. Does not sort icons (default). Displays the details. Displays a list (default). Displays the corresponding source text and source line, using the position of the selected event as the jump destination address. (Refer to "5.12.2 Jump function".) If no line information exists at the jump destination address, however, you cannot jump. Opens the Source Window. If an active Source Windowis open, that window is displayed in the forefront (so that it can be manipulated). Displays the Assemble window from the position of the selected event, which is used as the jump destination address. (Refer to "5.12.2 Jump function".) Opens the Assemble Window. If an active Assemble Windowis open, that window is displayed in the forefront (so that it can be manipulated). Displays the memory contents from the position of the selected event, which is used as the jump destination address. (Refer to "5.12.2 Jump function".) Opens the Memory Window. If an active Memory Windowis open, that window is displayed in the forefront (so that it can be manipulated). Cannot be selected. Assemble Memory Coverage 174 User's Manual U17287EJ1V0UM CHAPTER 6 WINDOW REFERENCE Function buttons (Related event function) Describes the all function buttons the related event dialogs (the Event Manager, the Event Dialog Box and the Break Dialog Box.) OK (Event Dialog Box) Automatically registers the event condition being edited, if any, and closes this dialog box. In the select mode An event condition is selected and the setting dialog box (indicated on the title bar) that called the Event Link Dialog Box is displayed again. If the calling dialog box has already been closed, the select mode is returned to the normal mode, and the Event Dialog Box is not closed. Otherwise, this dialog box will be closed. (Other than above dialog boxes) Automatically registers the event condition being edited, if any, and closes this dialog box. Each event condition becomes valid as soon as it has been registered. New... (Event Manager) Opens the dialog box to create new event condition. By clicking each button of Clear Restore Cancel/Close Help Event Link... Break Trace... User's Manual U17287EJ1V0UM 175 CHAPTER 6 WINDOW REFERENCE Snap Shot... Stub... Timer... DMM... Manager Add Event... Cannot be selected. Cannot be selected. Cannot be selected. Cannot be selected. Opens the Event Manager. Opens the Event Dialog Box in the select mode, and selects or newly creates an event condition to be set. The event condition will be added to the area selected when the < Add Event...> button is pressed. Opens the various event setting dialog box corresponding to the selected event condition (one). Each setting dialog box displays the contents of the selected event condition. Same operation as double-clicking the event icon or pressing the Enter key. Deletes the selected event condition. When an event condition is to be deleted, an error occurs and the event condition cannot be deleted if the event is used as a various event condition. Deletes all event conditions. Turns on (Expand>>>) or off (Shrink<<<) display of the event manager area. The size of the dialog box is expanded or reduced. The size of the dialog box is expanded or reduced. The event condition selected in Event Manager area add to setting area with a focus. Opens the Select Display Information dialog box. This dialog box is used to change the display mode and rearrange event names. Figure 6-40 Select Display Information Dialog Box Open Remove/Delete Delete All Expand >>>/ Shrink <<< Add Info... 176 User's Manual U17287EJ1V0UM CHAPTER 6 WINDOW REFERENCE Event Dialog Box This dialog box is used to register and display event conditions. (Refer to "5.9 Event Function".) Registering of event conditions is done by setting each item in this dialog box and then clicking the - Opening - Explanation of each area - Function buttons (Related event function) Opening In normal mode If the Event Dialog Box is opened as follows, an event condition can be registered without its purpose being specified. Click this button, or select [Event] menu -> [Event]. In select mode If the User's Manual U17287EJ1V0UM 177 CHAPTER 6 WINDOW REFERENCE Explanation of each area (1) Event Name: (2) Event Status: (3) Access Size: (4) Address: (5) Data:, Mask: (6) Pass Count: (7) Event Manager: (1) Event Name: This area is used to set an event name. Directly input an alphanumeric string of up to eight characters as a name. To display the contents of an already created event condition, select from the drop-down list. In the select mode, the selected event condition can be set in the event condition setting area of the setting dialog box that called the Event Dialog Box. The mark on the left of this area indicates the utilization status of events ("Table 5-12 Event Icon"). The gray E. mark indicates that the event condition is being edited and has not been registered yet. (2) Event Status: This area is used to set a status condition. By specifying a status condition, the type of the execution event and an access event is determined (if an execution event is specified, nothing can be input to the (3) Access Size: and (5) Data:, Mask: ). The status conditions that can be specified are listed below. Table 6-11 Status Condition Status Access event R/W Read Write RW R W Memory read/write Memory read Memory write Abbreviation Meaning (3) Access Size: This area is used to set an access size condition. By selecting an access size condition from the drop-down list, the access width of a data condition to be detected by an access event is determined. 178 User's Manual U17287EJ1V0UM CHAPTER 6 WINDOW REFERENCE Byte Bit Detects data condition with 8-bit width (only during 8-bit access). Detects data condition with 1-bit width (only during 8-bit access). In this case, a data condition is detected with 1-bit width. Because of the operation of the in-circuit emulator, access to a bit is not directly detected; the ID78K0S-QB detects a dummy bit access by internally setting address conditions and data conditions as follows: Input example: Address: FE20.1 Data: 1 | Setting of trace search: Address: FE20 Data: 00000010B Mask: 11111101B If another bit of the same address is accessed or if all the 8 bits of the same address are accessed, therefore, an event is detected in accordance with the specified status if the address and bit match the specified value of [address.bit]. When data is written to a bit, all the 8 bits are read/written. If read or read/write is specified as the status, an event occurs if a read operation is performed at this time if the value of the specified [Address.bit] matches. Remark If no access size condition is specified, a judgment is automatically made from the address condition and data condition, and the following is set: -Bit if the address condition is set in bit units -Byte if the address condition is set in 8-bit units (4) Address: This area is used to specify an address condition (address value). Table 6-12 Settable Range of Address Condition (Event) Settable range 0xF800 <= address value <= 0xFFFF 0 <= mask value <= 0xFFFF Remark (a) Address Select the address range (specification method) from a drop-down list and specify the address value in areas A: and B:. In the ID78K0S-QB, only "x == A" can be selected. The default radix for inputting a numeric value is hexadecimal. An address can be also specified by a symbol or expression (refer to "Table 5-5 Specifying Symbols"). x == A Specify address value specified for A: User's Manual U17287EJ1V0UM 179 CHAPTER 6 WINDOW REFERENCE (5) Data:, Mask: This area is used to set data conditions. The default radix for inputting a numeric value is hexadecimal. The settable range differs as follows depending on the access size condition specified in (3) Access Size: . Table 6-13 Settable Range of Data Condition Access Size Byte Bit 0 <= data value <= 0xFF 0 <= mask value <= 0xFF Data value = 0 or 1 Mask value = Cannot be specified. Settable range (a) Data: Select the data range (specification method) from a drop-down list and specify the address value in areas A: and B:. In the ID78K0S-QB, only "x == A" can be selected. The default radix for inputting a numeric value is hexadecimal. An address can be also specified by a symbol or expression (refer to "Table 5-5 Specifying Symbols"). x == A (b) Mask: Set a mask value for the data value. When a mask is set, the data value for the bit whose mask value is 1 may be 0 or 1. Example 1: Data Mask 0x4000 0xFF Specify data value matching data value specified for A: With this setting, addresses 0x4000 to 0x40FF satisfy the condition. Example 2: Data Mask 0x4000 0x101 With this setting, addresses 0x4000, 0x4001, 0x4100, and 0x4101 satisfy the condition. (6) Pass Count: Cannot be selected in this area. 180 User's Manual U17287EJ1V0UM CHAPTER 6 WINDOW REFERENCE (7) Event Manager: This area is used to display the list of the events registered. (Refer to "Table 5-12 Event Icon", "(4) Manipulation in event manager area".) Function Buttons Refer to " Function buttons (Related event function)" in the Event Manager. User's Manual U17287EJ1V0UM 181 CHAPTER 6 WINDOW REFERENCE Break Dialog Box This dialog box is used to register; set, and display break event conditions. (Refer to "5.9 Event Function", "5.4 Break Function".) Registration and setting of break event conditions is done by setting each item (256 items max.) in this dialog box and then clicking the - Opening - Explanation of each area - Function buttons (Related event function) Opening Click the Brk button, or select [Event] menu -> [Break...]. Explanation of each area (1) Break Name: (2) Break Event: (3) Event Manager: 182 User's Manual U17287EJ1V0UM CHAPTER 6 WINDOW REFERENCE (1) Break Name: This area is used to set a break event name. Directly input an alphanumeric string of up to eight characters as a name. To display the contents of an already created event condition, select from the drop-down list. The mark on the left of this area indicates the utilization status of events. (Refer to "Table 5-12 Event Icon"). The gray mark indicates that an event condition is being edited and has not been registered yet. mark, an event condition can be validated or invalidated. (2) Break Event: This area is used to set an event condition for break. The number of event conditions that can be set in this area is as follows: Table 6-14 Number of Events Settable in Break Condition Setting Area Connected IE QB-78K0SKX1MINI Total (before execution / after execution / access) 1 (0 / 0 / 1) By clicking the left Event conditions are easily set by dragging the icon of the event to be set from the event manager area and dropping it in this area. For details, refer to "5.9.3 Setting various event conditions". (3) Event Manager: This area is used to display the list of the events registered. (Refer to "Table 5-12 Event Icon", "(4) Manipulation in event manager area".) Function Buttons Refer to " Function buttons (Related event function)" in the Event Manager. User's Manual U17287EJ1V0UM 183 CHAPTER 6 WINDOW REFERENCE View File Save Dialog Box This dialog box is used to save the current display information of the current window to a view file. (Refer to "5.11.2 Window display information (view file)".) Figure 6-43 View File Save Dialog Box - Opening - Explanation of each area - Function buttons Opening When the window to be saved is the current window, select [File] menu -> [Save As...]. Explanation of each area (1) Save in:, File name: (2) Save as type: (3) Save range 184 User's Manual U17287EJ1V0UM CHAPTER 6 WINDOW REFERENCE (1) Save in:, File name: This area is used to specify the file name to be saved. A file name can be directly input from the keyboard, or selected from the list. Up to 257 character string with a extension can be specified. (2) Save as type: This area is used to specify the type (extension) of the file to be saved. (Refer to "Table 5-14 Type of the View Files".) The extension of the file corresponding to the current window is displayed. (3) Save range Specify the range of data to be saved. This area is displayed if the current window to be saved is the following. - Assemble Window - Memory Window - Source Window (a) All This should be selected to save the entire range, from the first line to the last line. (b) Screen shot This should be selected to save the area visible on the screen, from the top line on the screen to the bottom line. If the Source Window is in the mixed display mode, however, the window contents are saved from the source line that includes the area visible on the screen. (c) Specify Line / Specify Address This should be selected to specify the start line and end line of the area to be saved. If the start line and end line are omitted, the first line and last line are assumed. If a range of 100 lines / 256 bytes or more is specified, a message dialog box is displayed to indicate the progress of saving. To stop saving midway, click the Specify Address User's Manual U17287EJ1V0UM 185 CHAPTER 6 WINDOW REFERENCE Function buttons Save Cancel Help Restore Saves the display information of the current window to the selected file. After saving, this dialog box is closed. Closes this dialog box without executing anything. Displays this dialog box online help files. Restores the status before this dialog box was opened. 186 User's Manual U17287EJ1V0UM CHAPTER 6 WINDOW REFERENCE View File Load Dialog Box This dialog box is used to read the view files. (Refer to "5.11.2 Window display information (view file)".) When a view file is loaded, the reference window (Source Window in static status) opens and the display information at saving is displayed. The window to be opened and its status differ as follows, depending on the file to be loaded. - Loading source file to which symbol information has been read If there is a Source Window in the active status, it is opened in the static status; otherwise, the Source Window is opened in the active status. - Loading source file to which symbol information has not been read, or view file A window of text-format files is opened in the Source Window in the static status. Figure 6-44 View File Load Dialog Box - Opening - Explanation of each area - Function buttons Opening Click the Open button or select [File] menu -> [Open...]. Explanation of each area (1) Look In:, File name: (2) Files of type: User's Manual U17287EJ1V0UM 187 CHAPTER 6 WINDOW REFERENCE (1) Look In:, File name: This area is used to specify the file name to be loaded. A file name can be directly input from the keyboard, or selected from the list. Up to 257 character string with a extension can be specified. (2) Files of type: This area is used to specify the type (extension) of the file to be loaded. (Refer to "Table 5-14 Type of the View Files".) Function buttons Open Cancel Help Loads the selected file. After loading the file, this dialog box is closed. Closes this dialog box without executing anything. Displays this dialog box online help files. 188 User's Manual U17287EJ1V0UM CHAPTER 6 WINDOW REFERENCE Environment Setting File Save Dialog Box This dialog box is used to save the setting contents of the current window to a setting file. (Refer to "5.11.3 Window setting information (setting file)".) Figure 6-45 Environment Setting File Save Dialog Box - Opening - Explanation of each area - Function buttons Opening When the window to be saved is the current window, select [File] menu -> [Environment] -> [Save As...]. Explanation of each area (1) Save in:, File name: (2) Save as type: User's Manual U17287EJ1V0UM 189 CHAPTER 6 WINDOW REFERENCE (1) Save in:, File name: This area is used to specify the file name to be saved. A file name can be directly input from the keyboard, or selected from the list. Up to 257 character string with a extension can be specified. (2) Save as type: This area is used to specify the type (extension) of the file to be saved. (Refer to "Table 5-15 Type of the Setting Files"). The extension of the file corresponding to the current window is displayed. Function buttons Save Cancel Help Restore Saves the setting information of the current window to the selected file. After saving, this dialog box is closed. Closes this dialog box without executing anything. Displays this dialog box online help files. Restores the status before this dialog box was opened. 190 User's Manual U17287EJ1V0UM CHAPTER 6 WINDOW REFERENCE Environment Setting File Load Dialog Box This dialog box is used to read the setting files. (Refer to "5.11.3 Window setting information (setting file)".) When a setting file is loaded, the target window opens and the setting information at saving is restored. Figure 6-46 Environment Setting File Load Dialog Box - Opening - Explanation of each area - Function buttons Opening select [File] menu -> [Environment] -> [Open...]. Explanation of each area (1) Look In:, File name: (2) Files of type: User's Manual U17287EJ1V0UM 191 CHAPTER 6 WINDOW REFERENCE (1) Look In:, File name: This area is used to specify the file name to be loaded. A file name can be directly input from the keyboard, or selected from the list. Up to 257 character string with a extension can be specified. (2) Files of type: This area is used to specify the type (extension) of the file to be loaded. (Refer to "Table 5-15 Type of the Setting Files".) Function buttons Open Cancel Help Loads the selected file. After loading the file, this dialog box is closed. Closes this dialog box without executing anything. Displays this dialog box online help files. 192 User's Manual U17287EJ1V0UM CHAPTER 6 WINDOW REFERENCE Reset Debugger Dialog Box This dialog box is used to initialize the ID78K0S-QB, CPU, and symbol information. Figure 6-47 Reset Debugger Dialog Box - Opening - Explanation of each area - Function buttons Opening Select [File] menu -> [Debugger Reset...]. Explanation of each area (1) Reset subject selection area This area is used to specify what is to be Initialized. Initializes the checked item. Debugger Symbol Target CPU Initializes the ID78K0S-QB (default). Initializes the symbol information. Initializes the CPU. Function buttons OK Cancel Help Initializes according to the setting. Cancels the changes and closes this dialog box. Displays this dialog box online help files. User's Manual U17287EJ1V0UM 193 CHAPTER 6 WINDOW REFERENCE Exit Debugger Dialog Box This dialog box is used to select whether the current debug environment is saved to a project file or not before terminating the ID78K0S-QB. (Refer to "5.11.1 Debugging environment (project file)".) It can be specified in the Debugger Option Dialog Box that the ID78K0S-QB is terminated without this confirmation dialog box being opened. Figure 6-48 Exit Debugger Dialog Box - Opening - Function buttons Opening - Select [File] menu -> [Exit]. - If forcible termination, such as to terminate the application, has been executed on the task list that terminates Windows. Function buttons Yes Saves the current debug environment to a project file, closes all the windows, and terminates the ID78K0S-QB. If a project file name is not specified, the Project File Save Dialog Box is opened. If the < Cancel> button is selected on the Project File Save Dialog Box, the environment is neither saved to a project file nor is the ID78K0S-QB terminated. (If a project file is loaded or saved during debugger operation, this button has the default focus. ) Closes all the windows and terminates the ID78K0S-QB. (If a project file is not loaded or saved during debugger operation, this button has the default focus.) Closes this dialog box without executing anything. No Cancel 194 User's Manual U17287EJ1V0UM CHAPTER 6 WINDOW REFERENCE About Dialog Box This dialog box displays the version information of the ID78K0S-QB (the year is displayed in 4 digits). Remark The version information can be copied to the clipboard by selecting [Select All and Copy (&C)] from the context menu in the dialog box. The following version information is displayed: - Product version of ID78K0S-QB - Version of device file - Version of GUI - Version of debugger DLL - Version of assembler DLL - Version of executor - Version of Tcl/Tk - Product ID and product version of in-circuit emulator - Version of OCD Control Code Figure 6-49 About Dialog Box - Opening - Function buttons User's Manual U17287EJ1V0UM 195 CHAPTER 6 WINDOW REFERENCE Opening Select [Help] menu -> [About...], or click the Function buttons OK Closes this dialog box. 196 User's Manual U17287EJ1V0UM CHAPTER 6 WINDOW REFERENCE Console Window This window is used to input commands that control the ID78K0S-QB . Because the key bind is Emacs-like, the accelerator key is not acknowledged if the Console Window is active. However, the F1 key displays the online help files of the Console Window. While the Console Window is open, an error message window with only an - Opening Opening Select [Browse] menu -> [Console]. User's Manual U17287EJ1V0UM 197 CHAPTER 6 WINDOW REFERENCE Font Dialog Box This dialog box is used to select the font and font size to be displayed in the Source Window, the Watch Window, the Quick Watch Dialog Box, the Local Variable Window and the Stack Window. Figure 6-51 Font Dialog Box - Opening - Explanation of each area - Function buttons Opening Click the button in the Debugger Option Dialog Box. Explanation of each area 198 (3) (2) (1) Font Face: Size: Sample User's Manual U17287EJ1V0UM CHAPTER 6 WINDOW REFERENCE (1) Font Face: This area is used to select a font from the fonts currently usable. Only fonts with equal width (fonts with a constant stroke width and a fixed pitch) are enumerated. When a font name is selected from the list, the font name is displayed in the text box, and the font size that can be used with that font is displayed under (2) Size:. (2) Size: This area is used to specify the font size (unit: pt.). On the drop-down list, the font size usable for the font specified in (1) Font Face: is displayed in point units. When the font size is selected from the drop-down list, the selected font size is displayed in this area. The font size can also be directly input to the text box from the keyboard. (3) Sample This area displays a sample character string of the specified font and size. Function buttons OK Cancel Validates the settings and closes this dialog box. Cancels the changes and closes this dialog box. User's Manual U17287EJ1V0UM 199 CHAPTER 6 WINDOW REFERENCE Browse Dialog Box This dialog box is used to select the file to be set in the Source Text Move Dialog Box. Remark If this dialog box is opened for the first time after the system has been started up, the directory first specified by the source path is displayed. When the dialog box is opened the second and subsequent times, the previously displayed directory is recorded and displayed again. If the - Opening - Explanation of each area - Function buttons Opening Click the Explanation of each area (1) Look In:, File name: (2) Files of type: 200 User's Manual U17287EJ1V0UM CHAPTER 6 WINDOW REFERENCE (1) Look In:, File name: This area is used to specify the file name to be opened. A file name can be directly input from the keyboard, or selected from the list. Up to 257 character string with a extension can be specified. (2) Files of type: This area is used to specify the type (extension) of the file to be opened (refer to "Table 5-4 File Type Can Be Displayed"). Function buttons Open Cancel Help Sets the selected file. After setting the file, this dialog box is closed. Closes this dialog box without executing anything. Displays this dialog box online help files. User's Manual U17287EJ1V0UM 201 CHAPTER 7 COMMAND REFERENCE CHAPTER 7 COMMAND REFERENCE This chapter explains the details of the command functions of the ID78K0S-QB. - Command Line Rules - Command List - List of Variables - List of Packages - Key Bind - Expansion Window - Callback Procedure - Hook Procedure - Related Files - Cautions - Command Name - Samples (Calculator Script) 202 User's Manual U17287EJ1V0UM CHAPTER 7 COMMAND REFERENCE 7.1 Command Line Rules The specification of command lines has the following rules: - Command name, option, and argument are specified for command line. - To divide words, a space (space key or tab key) is used. - At the end of a line, a line feed character or a semicolon is used. - When a command name and an option are entered to the point of identifiability, they are recognized. - In script, command names have to be entered completely. Command format command -options arg1 arg2 arg3 ... User's Manual U17287EJ1V0UM 203 CHAPTER 7 COMMAND REFERENCE 7.2 Command List Table 7-1 List of Debugger Control Commands Command name address assemble batch breakpoint dbgexit download extwin finish go help hook inspect jump map mdi memory module next refresh register reset run step stop upload version watch where wish Evaluation of address expression Disassemble/line assemble Executing batch (with echo) Setting/deletion of breakpoint Terminating ID78K0S-QB Download of files Creation of expansion window Returning from function Continuous execution Display of help Setting of hook Symbol inspect Jump to window Setting / deleting memory mapping Setting of expansion window Display/setting of memory Display of the list of files and functions Procedure step Redrawing of window Function Display/setting of register value and SFR value Reset Reset and execution of CPU Step execution Stop execution Upload Display of the version information Display/setting of variables Stack trace Start of Tclet 204 User's Manual U17287EJ1V0UM CHAPTER 7 COMMAND REFERENCE Table 7-2 List of Console/Tcl Commands Command name alias cd clear echo exit history ls pwd source time tkcon unalias which Other Creation of another name Change of directory Clears the screen Echo Close/end Display of history Display of files Check of the directory Execution of batch Measurement of time for commands Console control Deletion of another name Display of the command path or another name Based on Tcl/Tk 8.4 Function 7.3 List of Variables - dcl(chip) - Chip name read only - dcl(prjfile) - Project file name read only - dcl(srcpath) - Source path read only - dcl(ieid) - IEtype read only - dcl(iestat) - IEstatus read only - dcl(bkstat) - Break status read only - env(LANG) - Language - dcl_version - Dclversion read only User's Manual U17287EJ1V0UM 205 CHAPTER 7 COMMAND REFERENCE 7.4 List of Packages - tcltest - Restoration test - cwind - Automatic window control - BWidget - Toolkit - tcllib - Tcl library - mclistbox - Multi-column list box - combobox - Combo box 7.5 Key Bind - tcsh + Emacs like - Complement of command name [Tab] - Complement of file name [Tab] - HTML help [F1] 7.6 Expansion Window The expansion windows can be created using Tk. In the expansion windows, Widget is allocated with '.dcl' as a root instead of '.'. When the following script files are allocated in bin/idtcl/tools/, an expansion window is added on selecting [Browse] menu - [Others]. The mdi command, an exclusive command for expansion windows, has been added. # Sample.tcl wm protocol .dcl WM_DELETE_WINDOW { exit } mdi geometry 100 50 button .dcl.b -text Push -command exit pack .dcl.b Caution In the expansion windows, Tk menu commands cannot be used because of the restrictions of MDI windows. 206 User's Manual U17287EJ1V0UM CHAPTER 7 COMMAND REFERENCE 7.7 Callback Procedure Expansion windows can hold dcl_asyncproc procedures called by asynchronous messages. proc dcl_asyncproc {mid} { if {$mid == 19} { redraw } } The asynchronous message ID is passed for the argument of the dcl_asyncproc procedure The message IDs are shown below: Table 7-3 Message ID Message ID 9 10 11 12 13 14 15 17 18 19 20 45 After changing configuration After registering event After deleting event Before executing After breaking After resetting CPU After resetting ID78K0S-QB After changing extended option After changing debugger option After downloading After changing memory or register After resetting symbol Meaning User's Manual U17287EJ1V0UM 207 CHAPTER 7 COMMAND REFERENCE 7.8 Hook Procedure A hook can be set in the ID78K0S-QB using the hook procedure. The hook procedures are shown below: - BeforeDownload(Hook before downloading) - AfterDownload(Hook after downloading) - AfterCpuReset(Hook after CPU reset during break) - BeforeCpuRun(Hook before starting execution) - AfterCpuStop(Hook after breaking) By using hook procedures, register values can be changed before downloading programs or after resetting the CPU. An actual example of the procedure is shown below. A hook is valid till the ID78K0S-QB is closed. (1) [When hook is set with ID78K0S-QB control command] 1) 2) 3) Create script file a. with an editor. Start up the ID78K0S-QB, select [Browse] menu -> [Console], and open the Console Window. If the script file is executed in the window as below, the hook in the script file is set. %hook test.tcl (2) [When hook is set on downloading of project file] 1) 2) Create script file a. with an editor.Note Start up the ID78K0S-QBand read test.prj. The hook in the script file is set. proc BeforeDownload {} { register MM 0x7 register PMC8 0xff register PMC9 0xff register PMCX 0xe0 } proc AfterCpuReset {} { register MM 0x7 register PMC8 0xff register PMC9 0xff register PMCX 0xe0 } Note Be sure that the script file name is the same as the project file. Example: The script file corresponding to test.prj is test.tcl. Allocate test.prj, test.pri, and test.tcl in the same directory. 208 User's Manual U17287EJ1V0UM CHAPTER 7 COMMAND REFERENCE 7.9 Related Files - Executes when the aliases.tcl console is opened. Sets the default alias etc. - Executes when the project file name.tcl project is opened. The following hooks can be used. BeforeDownload, AfterDownload, AfterCpuReset, BeforeCpuRun, AfterCpuStop - Executes when the load module name.tcl load module is downloaded. The following hooks can be used. BeforeDownload, AfterDownload, AfterCpuReset, BeforeCpuRun, AfterCpuStop 7.10 Cautions - The separator for file and path is a slash (/). - When a console is open, error messages are output to the console. - To terminate the command forcibly, close the console. - The execution of external commands (DOS commands) is OFF by default. 7.11 Command Name In this section, each command is explained using the format shown below. Command name Describes the command name. Input format Describes the input format of the command. In the following explanation, italics indicate an Argument to be supplied by the user, while the argument enclosed in "?" may be omitted. When a command name and an option are entered to the point of identifiability, they are recognized. Functions Explains the functions of the command. Usage example Shows an example of the usage of the command. User's Manual U17287EJ1V0UM 209 CHAPTER 7 COMMAND REFERENCE address address - Evaluation of address expression Input format address expression Functions Converts the address expression specified by expression into address. Usage example (IDCON) 1 % address main 0xaa (IDCON) 2 % address main+1 0xab 210 User's Manual U17287EJ1V0UM CHAPTER 7 COMMAND REFERENCE assemble assemble - Disassemble/line assemble Input format assemble ?options? address ?code? Functions Assembles the character strings specified by codefrom the address specified by address. When '.' is specified for address, it is understood as an address continuing from the immediately previous assemble. When code is omitted, it is assembled from the address specified by address. The following are options: They are ignored for assembly. -code -number number Command code is also displayed.It is ignored for assembly. number line is displayed. It is ignored for assembly. Usage example (IDCON) 1 % assemble -n 5 main 0x000000aa B7 PUSH HL 0x000000ab B1 PUSH AX 0x000000ac 891C MOVW AX,SP 0x000000ae D6 MOVW HL,AX 0x000000af A100 MOV A,#0H (IDCON) 2 % assemble main mov a,b (IDCON) 3 % assemble . mov a,b User's Manual U17287EJ1V0UM 211 CHAPTER 7 COMMAND REFERENCE batch batch - Executing batch (with echo) Input format batch scriptname Functions Executes in batch with displaying files specified by scriptname on the screen. Nesting is possible. Usage example (IDCON) 1 % clear (IDCON) 2 % batch bat_file.tcl (IDCON) 3 % tkcon save a:/log.txt 212 User's Manual U17287EJ1V0UM CHAPTER 7 COMMAND REFERENCE breakpoint breakpoint - Setting/deletion of breakpoint Input format breakpoint ?options? ?address1? ?address2? breakpoint -delete brkno breakpoint -enable brkno breakpoint -disable brkno breakpoint -information Functions Operates the breakpoint specified by options and address . If a breakpoint can be set correctly, the breakpoint number is returned. The following are options: -software -hardware -read -write -access -data value -datamask value -information -delete -disable -enable A software break is specified. A hardware break is specified (default). An address data read break is set. An address data write break is set. An address data access break is set. The data condition is set. The data mask is set. The list of breakpoints is displayed. The breakpoint whose number is specified is deleted. The breakpoint whose number is specified is disabled. The breakpoint whose number is specified is enabled. User's Manual U17287EJ1V0UM 213 CHAPTER 7 COMMAND REFERENCE Usage example (IDCON) 1 % breakpoint -software main 1 (IDCON) 2 % breakpoint -access v 1 (IDCON) 3 % breakpoint -i 1 Brk00001 enable _v (IDCON) 4 % breakpoint -disable 1 (IDCON) 5 % breakpoint -read gIvar 2 (IDCON) 6 % breakpoint -i 1 Brk00001 disable _v 2 Brk00002 enable _gIvar (IDCON) 7 % breakpoint -delete 1 (IDCON) 8 % breakpoint -i 2 Brk00002 enable _gIvar 214 User's Manual U17287EJ1V0UM CHAPTER 7 COMMAND REFERENCE dbgexit dbgexit - Terminating ID78K0S-QB Input format dbgexit ?options? Functions Terminate the ID78K0S-QB. The following are options: -saveprj Project is saved on terminating ID78K0S-QB. Usage example (IDCON) 1 % dbgexit -saveprj User's Manual U17287EJ1V0UM 215 CHAPTER 7 COMMAND REFERENCE download download - Download of files Input format download ?options? filename ?offset? Functions Downloads files specified with filename according to options. If offset is specified, the address is shifted by the offset (if the data is in binary format, the load start address is specified for offset). -binary -nosymbol -symbolonly -reset -information Binary format data is downloaded. Download is executed. Symbol information is not read. Symbol information is read. CPU is reset after download. Download information is displayed. Usage example (IDCON) 1 % download test.lmf 216 User's Manual U17287EJ1V0UM CHAPTER 7 COMMAND REFERENCE extwin extwin - Creation of expansion window Input format extwin scriptfile Functions Creates expansion window with scriptfile. Usage example (IDCON) 1 % extwin d:/foo.tcl User's Manual U17287EJ1V0UM 217 CHAPTER 7 COMMAND REFERENCE finish finish - Returning from function Input format finish Functions Executes until it returns to the program that called the current function. Usage example (IDCON) 1 % finish 218 User's Manual U17287EJ1V0UM CHAPTER 7 COMMAND REFERENCE go go - Continuous execution Input format go ?options? Functions Executes program continuously.If -waitbreak is specified, the command waits until the program stops. The following are options: -ignorebreak -waitbreak Breakpoint is ignored. The command waits for the program to stop. Usage example (IDCON) 1 % go -w User's Manual U17287EJ1V0UM 219 CHAPTER 7 COMMAND REFERENCE help help - Display of help Input format help Functions Displays Dcl help. Usage example (IDCON) 1 % help 220 User's Manual U17287EJ1V0UM CHAPTER 7 COMMAND REFERENCE hook hook - Setting of hook Input format hook scriptfile Functions Sets the procedure for hook with scriptfile. The hook setting is initialized when the project file is loaded and when the ID78K0S-QB is reset. Usage example (IDCON) 1 % hook d:/foo.tcl User's Manual U17287EJ1V0UM 221 CHAPTER 7 COMMAND REFERENCE inspect inspect - Symbol inspect Input format inspect ?options? progname pattern Functions Searches and displays the load module symbol specified with progname using the regular expression of pattern. The following regular expressions can be used. ? * [chars] \x The following are options: -nocase -address Does not distinguish between upper and lowercase. Displays in pair with symbol address. Match 1 character Match characters other than 0 Match chars character. (Range specification such as [a-z/0-9] also possible.) Match character x. (? * [ ] \ specification also possible.) Usage example (IDCON) 1 % inspect test1.out {[a-z]*} 222 User's Manual U17287EJ1V0UM CHAPTER 7 COMMAND REFERENCE jump jump - Jump to window Input format jump -source -line filename ?line? jump ?options? address Functions Displays the window specified by options. -source -assemble -memory -line -focus The Source Window is displayed from the address specified by address. The Assemble Window is displayed from the address specified by address. The Memory Window is displayed from the address specified by address. The command is moved to the line specified by line. The Focus is moved to the window displayed. Usage example (IDCON) 1 % jump -s main (IDCON) 2 % jump -s -l mainfile.c 10 (IDCON) 3 % jump -m array User's Manual U17287EJ1V0UM 223 CHAPTER 7 COMMAND REFERENCE map map - Setting/deletion of memory mapping Input format map options address1 address2 ?accsize? Functions Sets, deletes, and displays memory mapping. The following are options: -rrm Start address of RRM area is set. RRM area can be divided into 8 partitions. The start address and size are specified in pairs in list format as follows. {{address size} {address size} {address size} ...} size is one of 2,4,6,8,10,12,14,16 bytes, and the total size is up to 16. All the settings for the mapping are deleted. Refer to the setting for the mapping. -clear -information Usage example (IDCON) 1 % map -i 1: 0 0x7fff 8 {IROM} 2: 0x8000 0x87ff 8 {Target RRM} 3: 0x8800 0x9fff 8 {Target} 4: 0xa000 0xf7ff 8 {NonMap} 5: 0xf800 0xfaff - {NonMap} 6: 0xfb00 0xfedf 8 {Saddr} 7: 0xfee0 0xfeff 8 {Register} 8: 0xff00 0xffff 8 {SFR} 224 User's Manual U17287EJ1V0UM CHAPTER 7 COMMAND REFERENCE mdi mdi - Setting of expansion window Input format mdi geometry ?x y? width height mdi title string Functions Sets the size and title name of the expansion window. The command can be used only from the expansion window. Usage example (IDCON) 1 % mdi geometry 0 0 100 100 (IDCON) 2 % mdi title foo User's Manual U17287EJ1V0UM 225 CHAPTER 7 COMMAND REFERENCE memory memory - Display/setting of memory Input format memory ?options? address ?value? memory ?options? -fill address1 address2 value memory ?options? -copy address1 address2 address3 Functions Sets value in the memory of the address specified by address according to options. If value is omitted, display the value of the memory of the address specified by address. If -fill is specified, data from address1 to address2 is filled with value . If -copy is specified, data from address1 to address2 is copied to address3. The following are options: -byte -word -fill -copy -noverify Displayed/set in one-byte units (default). Displayed/set in word units. The data is filled in. The data is copied. Verification is not executed on writing. Usage example (IDCON) 1 % memory 100 0x10 (IDCON) 2 % memory 100 2 (IDCON) 3 % memory 100 0x02 (IDCON) 4 % memory -fill 0 1ff 0 226 User's Manual U17287EJ1V0UM CHAPTER 7 COMMAND REFERENCE module module - Display of the list of files and functions Input format module progname ?filename? Functions Displays the list of files and functions of the load module specified by progname. If filename is not specified, the list of files is displayed. If filename is specified, the list of functions of the specified files is displayed. Usage example (IDCON) 1 % module rammon.lmf 1: rammon.c (IDCON) 2 % module rammon.lmf rammon.c 1: rammon.c sub1 2: rammon.c main User's Manual U17287EJ1V0UM 227 CHAPTER 7 COMMAND REFERENCE next next - Procedure step Input format next ?options? Functions Executes the procedure steps. If functions are called, the step stops after executing function. The following are options: -source -instruction The command is executed in source line units (default). The command is executed in command units. Usage example (IDCON) 1 % next -i (IDCON) 2 % next -s 228 User's Manual U17287EJ1V0UM CHAPTER 7 COMMAND REFERENCE refresh refresh - Redrawing of window Input format refresh Functions Redraws the window and updates the data. Usage example (IDCON) 1 % batch foo.tcl (IDCON) 2 % refresh User's Manual U17287EJ1V0UM 229 CHAPTER 7 COMMAND REFERENCE register register - Display/setting of register value and SFR value Input format register ?options? regname ?value? Functions Sets value in the register specified with regname. If value is omitted, displays the value of the register specified by regname. The following are options: -force Compulsory reading or writing is executed. Usage example (IDCON) 1 % register pc 0x100 (IDCON) 2 % register pc 200 (IDCON) 3 % register pc 0x200 230 User's Manual U17287EJ1V0UM CHAPTER 7 COMMAND REFERENCE reset reset - Reset Input format reset ?options? Functions Resets the ID78K0S-QB , CPU, symbols or events. If options are omitted, the CPU is reset. The following are options: -cpu -debugger -symbol -event CPU is reset (default). The ID78K0S-QB is reset. Symbol is reset. Event is reset. Usage example (IDCON) 1 % reset User's Manual U17287EJ1V0UM 231 CHAPTER 7 COMMAND REFERENCE run run - Reset and execution of CPU Input format run ?options? Functions Resets the program and executes it. If -waitbreak is not specified, the command does not wait until the program stops. The following are options: -waitbreak The command waits for the program to stop. Usage example (IDCON) 1 % run (IDCON) 2 % run -w 232 User's Manual U17287EJ1V0UM CHAPTER 7 COMMAND REFERENCE step step - Step execution Input format step ?options? Functions Executes step execution. If functions are called, the command stops at the head of the functions. The following are options: -source -instruction The command is executed in source line units (default). The command is executed in instruction units. Usage example (IDCON) 1 % step -i (IDCON) 2 % step -s User's Manual U17287EJ1V0UM 233 CHAPTER 7 COMMAND REFERENCE stop stop - Stop executing Input format stop Functions Stops the program forcibly. Usage example (IDCON) 1 % run (IDCON) 2 % stop 234 User's Manual U17287EJ1V0UM CHAPTER 7 COMMAND REFERENCE upload upload - Upload Input format upload ?options? filename address1 address2 Functions Saves the memory data within the specified range in a file. The following are options: -binary -intel -motorola -tektronix -force The data is saved in binary format. The data is saved in Intel HEX format (default). The data is saved in Motorola HEX format. The data is saved in Tektronix HEX format. The file is overwritten. Usage example (IDCON) 1 % upload -b foo.hex 0 0xffff User's Manual U17287EJ1V0UM 235 CHAPTER 7 COMMAND REFERENCE version version - Display of the version information Input format version Functions Displays the version of the ID78K0S-QB. Usage example (IDCON) 1 % version GUI : V2.81 [XX XXXX 200X] Devicefile : 78K/0S[uPD78F9222] V9.99 Debugger : 78K0S-QB Debugger V3.33 XX XXXX 200X] Executer : 78K0S MINICUBE Executer V1.00f Micro program : OCD Control Code V1.00 Assembler : 78K0S Asm/Disasm V2.81 XX XXXX 200X] Tcl/Tk : 8.4.5 236 User's Manual U17287EJ1V0UM CHAPTER 7 COMMAND REFERENCE watch watch - Display/setting of variables Input format watch ?options? variable ?value? Functions Displays and sets the variables. The following are options: -binary -octal -decimal -hexdecimal -string -sizeof -encoding name The value is displayed in binary digits. The value is displayed in octal digits. The value is displayed in decimal digits. The value is displayed in hexdecimal digits. The value is displayed in character strings. The size, instead of the value, of variables is displayed in decimal digits. Encoding during character string display is specified. By default, system encoding is used. name (encoding name) is based on the Tcl specification (shiftjis, euc-jp, etc.). Usage example (IDCON) 1 % watch var 0x10 (IDCON) 2 % watch -d var 16 (IDCON) 3 % watch array\[0\] 0xa User's Manual U17287EJ1V0UM 237 CHAPTER 7 COMMAND REFERENCE where where - Stack trace Input format where Functions Executes the back-trace of the stack. Usage example (IDCON) 1 % where 1: test2.c#sub2(int i)#13 2: test.c#num(int i)#71 3: test.c#main()#82 238 User's Manual U17287EJ1V0UM CHAPTER 7 COMMAND REFERENCE wish wish - Startup of Tclet Input format wish scriptname Functions Starts up the script using Tk (Tclet). The expansion window can be created with Tclet. Usage example (IDCON) 1 % wish test.tcl User's Manual U17287EJ1V0UM 239 CHAPTER 7 COMMAND REFERENCE 7.12 Samples (Calculator Script) The script of the expansion window in which the calculator script is described and its execution screen are shown below. Script of expansion window # Calculator.tcl mdi geometry 100 100 set top .dcl entry $top.e -relief sunken -textvariable v frame $top.f -height 120 -width 120; pack $top.e -fill x; pack $top.f -fill both -expand 1set i 0; set v {}; set r 0.25 foreach n {7 8 9 / 4 5 6 * 1 2 3 - 0 = + C} { if {$n == "=" || $n == "C"} { button $top.f.b$n -text $n } else { button $top.f.b$n -text $n -command "$top.e insert end $n" } place $top.f.b$n -relx [expr ($i%4)*$r] -rely [expr ($i/4)*$r] -relw $r -relh $r } bind $top.f.bC <1> {$top.e delete 0 end} bind $top.f.b= <1> {catch {expr $v} v} Figure 7-1 Execution Screen incr I 240 User's Manual U17287EJ1V0UM APPENDIX A EXPANSION WINDOW APPENDIX A EXPANSION WINDOW - Overview - Sample List of Expansion Window - Activation - Explanation of Each Sample Window A.1 Overview With the ID78K0S-QB, the user can create custom windows in addition to the existing windows. The Tcl (Tool Command Language) interpreter and the commands for controlling the debugger are implemented in the ID78K0S-QB. Users can create windows using this Tcl. The ID78K0S-QB is supplied with samples of the following expansion windows. A.2 Sample List of Expansion Window Table A-1 List of Expansion Window (Sample) Window Name Function Displays a list of the source files and functions. Searches a character string. Sets the hook procedure. List Window Grep Window Hook Window A.3 Activation The expansion window can be activated by selecting List, Grep, or Hook in [Others] on the [Browse] menu. Remark Each .tcl file is installed in NECTools32\BIN\idtcl\tools. A.4 Explanation of Each Sample Window User's Manual U17287EJ1V0UM 241 APPENDIX A EXPANSION WINDOW List Window The lists of the source files and functions are displayed in a tree format in this window. When a function name in the list is clicked, the corresponding source is displayed. Figure A-1 List Window When a function name in the list is clicked, the corresponding function portion is displayed in the Source window. 242 User's Manual U17287EJ1V0UM APPENDIX A EXPANSION WINDOW Grep Window Search for a character string is performed in the files under the source path. When the search result is clicked, the corresponding source is displayed. Figure A-2 Grep Window By clicking a character string line in the search result,the coressponding character string portion is displayed in the Source window. Object Pattern button Function Input the character string to be searched. Marks the searched character string. Clears the marking. Put the cursor on a section in the search result and click this button to open the corresponding file. Select whether or not to distinguish uppercase and lowercase. Specify the type of the file to be searched. User's Manual U17287EJ1V0UM 243 APPENDIX A EXPANSION WINDOW Hook Window This window is used to set a hook to the debugger, using a hook procedure. The hook procedure enables changing the register value before downloading a program, or after a CPU reset. On this window, a hook can be set by using the following four tabs. - [BeforeDownload] tab: Hook before downloading - [AfterCpuReset] tab: Hook after CPU reset during break - [BeforeCpuRun] tab: Hook before start of execution - [AfterCpuStop] tab: Hook after break If the setting is saved as "project-file-name.tcl" in the directory where the project is stored, the setting is executed when the project is next opened. Figure A-3 Hook Window Object [BeforeDownload]Tab Function Hook before downloading Before downloading is performed, the register values input to the tab are automatically overwritten by the specified value. Hook after CPU reset during break after resetting CPU, the register values input to the tab are automatically overwritten by the specified value. Hook before starting execution before starting execution, the register values input to the tab are automatically overwritten by the specified value. Hook after breaking After breaking, the register values input to the tab are automatically overwritten by the specified value. All the commands described on the tabs are tested. Saves all the tab contents to a file. If the ID78K0S-QB was activated from a project file, the file is saved as "project-filename.tcl". [AfterCpuReset]Tab [BeforeCpuRun]Tab [AfterCpuStop]Tab 244 User's Manual U17287EJ1V0UM APPENDIX A EXPANSION WINDOW Object Function Clears all the descriptions on the tabs. Caution Specify the general-purpose register and the SFR for the register name. User's Manual U17287EJ1V0UM 245 APPENDIX B INPUT CONVENTIONS APPENDIX B INPUT CONVENTIONS - Usable Character Set - Symbols - Numeric Values - Expressions and Operators - File Names B.1 Usable Character Set Table B-1 List of Character Set Classification Alphabetic characters Numerals Character equivalent to alphabetic character Character Uppercase: A B C D E F G H I J K L M N O P Q R S T U V W X Y Z Lowercase: a b c d e f g h i j k l m n o p q r s t u v w x y z 0123456789 @_? Table B-2 List of Special Characters Character ( ) + * / % ~ Name Left parenthesis Right parenthesis Plus Minus Asterisk Slash Percent Tilde Vertical line Circumflex Ampersand Left bracket Right bracket Changes operation order. Changes operation order. Usage Addition operator or positive sign Subtraction operator or negative sign Multiplication operator or indirect reference operator Division operator Remainder operator Complement operator Bit sum operator Bit difference operator Bit product operator or address operator Array subscript operator or indirect display symbol | ^ & [ ] 246 User's Manual U17287EJ1V0UM APPENDIX B INPUT CONVENTIONS Character ! $ # . , Name Exclamation Dollar Sharp mark Period Comma Usage Absolute addressing start symbol Relative addressing start symbol Symbol indicating an immediate value Direct member operator or bit position specifier Delimiter between operands B.2 Symbols - A symbol consists of characters A to Z, a to z, @, _ (underbar), ?, and 0 to 9. - A symbol must start with a character other than numerals 0 to 9. - Uppercase characters (A to Z) and lowercase characters (a to z) are distinguished. - A symbol must be no more than 2048 characters long (if a symbol of more than 2048 characters is defined, only the first 2048 characters are valid). - A symbol is defined by loading a load module file. - Symbols are classified into the following types by the valid range: (i) (ii) Global symbol (assembly language, structured assembly language, C language) Static symbol (C language) In-file static symbol In-function static symbol (iii) Local symbol (C language) In-module local symbol (assembly language, structured assembly language) In-file local symbol In-function local symbol In-block local symbol - The following symbols are available for each language used: (i) Assembly language, structured assembly language , label name, constant name, bit symbol name (ii) C language Variable name (including pointer variable name, enumeration type variable name, array name, structure name, and union name) Function name, label name Array element, structure element, union element, bit field (if the symbol is an array, structure, or union) - A symbol can be described instead of an address or numeric value. User's Manual U17287EJ1V0UM 247 APPENDIX B INPUT CONVENTIONS - The valid range of a symbol is determined based on the source debug information when the source file is assembled or compiled. - Describe only the symbol name of a global symbol. - A local symbol is expressed in pairs with a file name. B.3 Numeric Values The following four types of numeric values can be used. The input format of each type is as shown below. The suffix (bold) and the alphabetic characters of hexadecimal numbers may be uppercase or lowercase characters. If the first character is A to F, 0 must be prefixed to it. In the input field of ID78K0S-QB, decimal numbers or hexadecimal numbers are alternately selected, depending on the default radix. Table B-3 Input Format of Numeric Values Numeric Value Binary number Octal number nY n...nY (n=0,1) nO n...nO (n=0,1,2,3,4,5,6,7) nQ n...nQ (n=0,1,2,3,4,5,6,7) n n...n nT n...nT (n=0,1,2,3,4,5,6,7,8,9) n n...n nH n...nH 0xn 0xn...n (n=0,1,2,3,4,5,6,7,8,9,A,B,C,D,E,F) Input Format Decimal number Hexadecimal numbers B.4 Expressions and Operators (1) Expressions An expression consists of constants, register names, SFR name and symbols coupled by operators. If SFR name, label name, function name, or variable name is described as a symbol, an address is calculated as the value of the symbol. The elements making up an expression, except operators, are called terms (constants and labels). Terms are called the first term, the second term, and so on, starting from the left. 248 User's Manual U17287EJ1V0UM APPENDIX B INPUT CONVENTIONS (2) Operators The following operators of the C language can be used: Table B-4 List of Operators Symbol Arithmetic operator + * / MOD % - sign + sign Logical operator NOT ~ AND & OR | XOR ^ Shift operator SHR >> SHL << Right shift Shifts the value of the first term by the value (number of bits) of the second term to the right, and returns the results. As many 0s as the number of shifted bits are inserted in the higher bits. Shifts the value of the first term by the value (number of bits) of the second term to the left, and returns the results. As many 0s as the number of shifted bits are inserted in the lower bits. Negation Logical product Logical sum Exclusive logical sum Logically negates each bit of the term, and returns the results. Obtains the logical product of the values of the first and second terms on each bit, and returns the results. Obtains the logical sum of the values of the first and second terms on each bit, and returns the results. Obtains the exclusive logical sum of the values of the first and second terms on each bit, and returns the results. Addition Subtraction Multiplication Division Remainder Unary operator (negative) Unary operator (positive) Returns the sum of the first and second terms. Returns the difference between the first and second terms. Returns the product of the first and second terms. Divides the value of the first term by the value of the second term, and returns the integer of the results. Divides the value of the first term by the value of the second term, and returns the remainder of the results. Returns 2's complement of the value of the term. Returns the value of the term. Meaning Explanation Left shift Byte separation operator HIGH LOW Higher byte Lower byte Of the lowest 16 bits of the term, returns the higher 8 bits. Of the lowest 16 bits of the term, returns the lower 8 bits. Word separation operator HIGHW LOWW Other Higher word Lower word Of the 32 bits of the term, returns the higher 16 bits. Of the 32 bits of the term, returns the lower 16 bits. User's Manual U17287EJ1V0UM 249 APPENDIX B INPUT CONVENTIONS Symbol ( ) Meaning Left parenthesis Right parenthesis Explanation Performs the operation in ( ) before the operation outside ( ). '(' and ')' are always used in pairs. (3) Rules of operation Operations are performed according to the priority of the operators. Table B-5 Operator Priority Priority 1 2 3 4 5 6 Lower Higher (,) + sign, - sign, NOT, ~, HIGHT, LOW, HIGHW, LOWW *, /, MOD, %, SHR, >>, SHL, << +, AND, & OR, |, XOR, ^ Operators - If the priorities of the operators are the same, the operation is performed from the left toward the right. - Performs the operation in ( ) before the operation outside ( ). - Each term in an operation is treated as unsigned 32-bit data. - All operation results are treated as unsigned 32-bit data. - If an overflow occurs during operation, the lower 32 bits are valid, and the overflow is not detected. (4) Terms To describe a constant for a term, the following numeric values can be described. Table B-6 Range of Radixes Radix Binary number Octal number Decimal number Hexadecimal numbers Range 0Y <= value <= 1111111111111111111111111111111Y (32 digits) 0O <= value <= 37777777777O -2147483648 <= value <= 4294967295 (A negative decimal number is internally converted into a 2's complement.) 0H <= value <= 0FFFFFFFH 250 User's Manual U17287EJ1V0UM APPENDIX B INPUT CONVENTIONS B.5 File Names The following regulations apply to the source file names and load module file names. (1) Source file names and load module file names File names are composed of a to z, A to Z, 0 to 9, ., _, +, and -. File names must start with a character other than ., +, or -. File names cannot be prefixed or suffixed by a period (.) or space. File names are not case-sensitive. A file name consists of up to 259 characters including the path. (2) Other file names Other file names comply with Windows file name regulations. The following characters cannot be used in file names. \/:*?"<>|; File names cannot be prefixed or suffixed by a period (.) or space. File names are not case-sensitive. A file name consists of up to 259 characters including the path. User's Manual U17287EJ1V0UM 251 APPENDIX C KEY FUNCTION LIST APPENDIX C KEY FUNCTION LIST Table C-1 Key Function List Key BackSpace Function Deletes one character before the cursor and moves the cursor to the position of the deleted character. At this time, the character string following the cursor moves forward. - Deletes one character after the cursor and move the character string following the cursor forward. - Deletes a various event condition selected in the Event Manager or each event dialog box. - Deletes the data selected in the Watch Window. Alternately selects the insert mode and overwrite mode in the Source Window and Assemble Window. However, this key is invalid in the Memory, Register, and IOR Windows, and only the overwrite mode can be used as an input mode. Loads the entire display screen to the clipboard as a bitmap image (function of Windows). - Closes the pull-down menu. - Closes the modal dialog box. - Restores the input data. Moves the cursor to the menu bar. Moves the cursor to the end of the line. Moves the cursor to the beginning of the line. Scrolls the screen one screen up. The cursor also moves up to the top of the screen. Scrolls the screen one screen down. The cursor also moves up to the top of the screen. Inserts one blank character. Moves the cursor to the next item. Moves the cursor up. If the cursor is at the bottom of the screen, scrolls the screen up one line at a time. Moves the cursor down. If the cursor is at the top of the screen, scrolls the screen down one line at a time. Moves the cursor to the left. If the cursor is at the left most position on the screen, scrolls the screen one column to the right. Moves the cursor to the right. If the cursor is at the right most position on the screen, scrolls the screen one column to the left. - Sets the input data. - Presses the default push button. Opens the Help window. Delete Insert PrintScreen Esc Alt End Home PageUp PageDown Space Tab Up arrow key Down arrow key Right arrow key Left arrow key Enter F1 252 User's Manual U17287EJ1V0UM APPENDIX C KEY FUNCTION LIST Key F2 F3 F4 F5 F6 F7 F8 F9 F10 F11 Shift+End Shift+Home Shift+Left arrow key Shift+Right arrow key Shift+F6 Shift+F9 Ctrl+End Ctrl+Home Ctrl+Left arrow key Function Forcibly stops program execution. Same function as [Run] menu -> [Stop]. Resets the CPU. Same function as [Run] menu -> [CPU Reset]. Resets the CPU and executes the program. Same function as [Run] menu -> [Restart]. Executes the program. Same function as [Run] menu -> [Go]. Executes the program to the cursor position in the Source or Assemble Window. Same function as [Run] menu -> [Come Here]. The user program is real-time executed until execution returns. Same function as [Run] menu -> [Return Out]. Step execution. Same function as [Run] menu -> [Step In]. Sets a breakpoint at cursor position in Source or Assemble Window. Same function as [Run] menu -> [Break Point]. Next step execution. Same function as [Run] menu -> [Next Over]. Sets or deletes a software breakpoint. Same function as [Run] menu -> [Software Break Point]. Expands the selection range to the end of the line. Expands the selection range to the beginning of the line. Expands the selection range one character to the left. Expands the selection range one character to the right. Executes the program from the cursor position in the Source or Assemble Window. Same function as [Run] menu -> [Start From Here]. Resets the CPU. Same function as [Run] menu -> [CPU Reset]. Displays the last line. The cursor will also move to the last line. Displays the first line. The cursor will also move to the first line. Moves the cursor one word to the left. If the cursor at the left most position on the screen, scrolls the screen one column to the right. Moves the cursor one word to the right. If the cursor at the right most position on the screen, scrolls the screen one column to the left. Ignores break points being set, and executes the program. Same function as [Run] menu -> [Ignore break points and Go]. Sets the address at the cursor position in the Source Window or Assemble Window to the PC. Same function as [Run] menu -> [Change PC]. Selects all the events registered to the Event Manager. Same function as [View] menu -> [Select All Event] in the Event Manager. Copies a selected character string and saves it to the clipboard buffer. Ctrl+Right arrow key Ctrl+F5 Ctrl+F9 Ctrl+A Ctrl+C User's Manual U17287EJ1V0UM 253 APPENDIX C KEY FUNCTION LIST Key Ctrl+D Function Disassembles and displays the results from the jump destination address specified by the data value selected in the current window.Opens the Assemble Window. Same function as [Jump] menu -> [Assemble]. Opens the source file displayed in the active Source Window with the editor specified by the PM plus when the PM plus is running. Same function as [Edit] menu -> [Edit Source]. Performs a search.Opens the search dialog box corresponding to the current window. Same function as [View] menu -> [Search...]. Moves the display position. Opens the each dialog box, depending on the current window. Same function as [View] menu -> [Move...]. Displays the memory contents from the jump destination address specified by the data value selected in the current window. Opens the Memory Window. Same function as [Jump] menu -> [Memory...]. Loads a view file, source file, or text file. Opens the View File Load Dialog Box. The operation will differ depending on the extension of the file. view file: Displays the file in the corresponding window. Others: Displays the file in the Source Window. Same function as [File] menu -> [Open...]. Saves the data displayed in the current window to the view file. Same function as [View] menu -> [Save...]. Displays the corresponding source text and source line, using the data value selected in the current window as the jump destination address. Opens the Source Window. Same function as [Jump] menu -> [Source Text]. Pastes the contents of the clipboard buffer to the text cursor position. Temporarily displays the contents of the specified data. Opens the Quick Watch Dialog Box. Same function as [View] menu -> [Quick Watch...]. Cuts a selected character string and saves it to the clipboard buffer. Same function as [Edit] menu -> [Cut]. Expands the selection range one word to the left. Expands the selection range one word to the right. Ctrl+E Ctrl+G Ctrl+J Ctrl+M Ctrl+O Ctrl+S Ctrl+U Ctrl+V Ctrl+W Ctrl+X Ctrl+Shift+Left arrow key Ctrl+Shift+Right arrow key 254 User's Manual U17287EJ1V0UM APPENDIX D MESSAGES APPENDIX D MESSAGES - Display Format - Types of Messages - Message Lists D.1 Display Format Messages are output to the error/warning dialog box. By pressing the F1 key while the error/warning dialog box is open, the related online help files are displayed. Figure D-1 Error/Warning Messages Error types Error No.(hexadecimal number) D.2 Types of Messages The ID78K0S-QB outputs the following types of messages. Table D-1 Types of Messages Types Axxxx Meaning Fatal error messages Stops processing, and terminates the debugger. If this error occurs, debugging cannot be continued. Syntax error messages Stops processing, and opened windows and dialog boxes are closed. Warning messages or question messages Stops processing, but opened windows and dialog boxes are not closed. Fxxxx Wxxxx User's Manual U17287EJ1V0UM 255 APPENDIX D MESSAGES D.3 Message Lists < X0000~ > < X1000~ > < X2000~ > < X3000~ > < X4000~ > < X5000~ > < X6000~ > < X7000~ > < X8000~ > < X9000~ > < Xa000~ > < Xb000~ > < Xc000~ > 256 User's Manual U17287EJ1V0UM APPENDIX D MESSAGES A01af: Failed in executing monitor command. A01b0: Can not communicate with monitor program. Please check the availability of communication port, the setting of CPU board or the type of cable. A01b1: Can not communicate with monitor program. Please terminate the debugger and check the power of CPU board or the connection of cable then restart the debugger. F0200: Verification error occurred. Failed in writing memory. 1) External memory could not be accessed, as it is not set. Change the register values necessary for accessing the external memory using the SFR Window or Hook Procedure before download. F02a0: Bus hold error. 1) CPU is in the bus-hold status. Reset the debugger. F02a2: Can not compulsory break. F02a3: Reset under continuation. F0300: User program is running. F0301: User program is being breaked. F0302: User program is being traced. F0303: Not traced. F0304: Trace memory is not set. F0306: No trace block exists. F0307: No event condition exists. F0308: No timer measurement is done. F0309: No trigger frame exists. F030a: Tracer is being stopped. F030b: Specified snap-event has not been registered. F030c: Specified stub-event has not been registered. F030d: Timer is running. F030e: Memory copy area is overlapped. F030f: Trace has been already set. F0310: Event condition is not set. F0311: Too many valid timer event conditions. F0312: Specified timer event is not set. F0313: Illegal map range. 1) Check the map range in the Configuration Dialog Box. When mapping to external memory has been performed, change the register values necessary for accessing the external memory using the SFR Window or Hook Procedure before download). F0314: Only trace delay mode can set with delay trigger. F0315: Delay trigger cannot set without trace delay mode. F0316: Overflowed the number of mapping. User's Manual U17287EJ1V0UM 257 APPENDIX D MESSAGES F03a0: Target is not turned on. 1) Check the target power supply. Check the cable connecting the in-circuit emulator and target board. Check that the VDD signal is input to the connector of the target board. F03a1: Step execution is being done. F03a2: Timer and Tracer are running. F03a3: Event link and BRS events are mixed. F03d0: Back-trace is being executed. F03d1: Back-trace is being stopped. F03d2: Back-trace execution point overrun oldest frame. F03d3: Register status or Memory status cannot be set up other than Phase1 of event link. F03d4: No back-trace information exists. F03d5: Last command can not be backstepped. F0400: Illegal condition. 1) Settings of the used in-circuit emulator and those of the Configuration Dialog Box may not match. Check the Chip selection. F0401: Result of timer measurement overflowed. F0402: Too many event conditions with path count. F0403: Too many address range conditions. F0404: Too many simultaneously-usable-event conditions. F0405: Too many snap-events. F0406: Too many stub-events. F0407: Too many initialization data. F0408: Too large search data (> 16 byte). F0409: Too large search data (> search range). F040a: Too many Linking-event conditions. F04a0: Software break conditions number overflow. F04a1: Not enough memory for emulation. F04a2: Too many partition of bus size. F04a3: Too many execution-event conditions. F04a4: Too many bus-event conditions. A0600: Not enough memory for buffer. 1) There is not enough system memory. Close the applications being executed and the open files. A0601: Not enough resource of operating system. F0b20: This event number can not be used. F0b61: Section Trace event conditions overflow. F0b80: Reset by hardware error. F0c33: Disabling the on-chip debug function is prohibited. 258 User's Manual U17287EJ1V0UM APPENDIX D MESSAGES F0c34: Writing to the on-chip debug reserved area is prohibited. F0ca2: This device file does not include the on-chip debug information. 1) An attempt was made to start with a device file not supporting on-chip debugging. The device file may be old. Install the latest device file . F0ca3: Unsupported information is included in the on-chip debug information in the device file. 1) An unknown flag is included in the on-chip debug information of the device file.The exec module may be old. Install the latest exec module. (2) X1000~ A1000: Failed in initializing ICE. A1001: No entry exists for specified number. A1002: Can not relocate internal RAM. F1003: Illegal relocation address. F1004: Illegal condition. A1005: Invalid attribute. F1006: Illegal address. A1007: Not enough memory on ICE. A1008: Not enough memory for tables. 1) There is not enough system memory. Close the applications being executed and the open files. A1009: Already initialized. A100a: Not initialized. F100b: User program is running. F100c: Different bus size has been already specified. F100d: Too large bus size. F100e: Too large bus partition size. W100f: Target is not turned on. F1010: Illegal map range. F1011: Failed in setting internal ROM and RAM. F1012: This feature is not supported. F1013: No terminal name. W1014: Data is not exist. A1015: Programmable-IOR does not exist. F1016: Programmable-IOR does not movable. 1) Necessary files may be damaged. Reinstall the latest device file. F1017: I/O Protect mapping is possible a target attribute only. F1018: Illegal Internal ROM size. A10ff: Can not communicate with ICE. User's Manual U17287EJ1V0UM 259 APPENDIX D MESSAGES A1dbe: Error occurred inside debugger. (3) X2000~ F2000: Illegal SFR name. A2001: Illegal address. F2002: User program is running. F2003: Illegal SFR number. F2004: Illegal bit number. W2005: SFR of Read Protect attribute was specified. F2006: Hidden SFR was specified. F2007: SFR of ban read or write was specified. F2008: SFR not existing was specified. A2009: Device file is damaged or error is in file. F200a: Illegal value specified for SFR. A200b: Can not copy. A200c: Not enough memory. 1) There is not enough system memory. Close the applications being executed and the open files. W200d: No initialize data for SFR. F200e: SFR area can not be accessed. A20ff: Can not communicate with ICE. A2222: Illegal condition. (4) X3000~ F3000: No mapped address was accessed. 1) The allocation addresses of the program and the addresses of the debugger may not match. Set the mapping to the external memory in the Configuration Dialog Box according to the allocation addresses specified in the link directive file on compilation. When mapping to external memory has been executed, change the register values necessary for accessing the external memory using the SFR Window or Hook Procedure before download. F3001: Memory has different value. F3002: Illegal start address. F3003: Illegal end address F3004: Illegal start address and end address. F3005: Illegal condition. F3006: User program is running. F3007: Verification error. 260 User's Manual U17287EJ1V0UM APPENDIX D MESSAGES F3008: No condition specified. F3009: Parameter size does not align with access size alignment. F300a: Specified address does not align with access size alignment. F300b: Source address does not align with access size alignment. F300c: Destination address does not align with access size alignment. F300d: Illegal end address. F300e: Different access size in specified area. F300f: Different access size both in source and destination areas. F3010: Different access size in destination area. F3011: Different access size, source & destination. A3012: Not enough memory. 1) There is not enough system memory. Close the applications being executed and the open files. F3013: Failed in writing DMM. F3014: Oveflowed mapping area. F3015: Processing was interrupted. F3016: This feature is not supported. A30ff: Can not communicate with ICE. (5) X4000~ F4000: Can not delete specified event. 1) The specified event cannot be deleted as it is being used under another condition. Invalidate it for other usages before deleting. F4001: Illegal table number. F4002: Illegal start address. F4003: Illegal end address. F4004: Illegal status. F4005: Illegal data. F4006: Specified event number has been already used. F4007: Too many same events are registered. F4008: Specified event has not been registered. F4009: Illegal data size. F400a: Illegal mode. F400b: Setting value is inaccurate. F400c: Event link conditions cannot be used for section trace conditions. F400d: Too many identical events are registered (>= 32767). F400e: Specified event condition does not exist. User's Manual U17287EJ1V0UM 261 APPENDIX D MESSAGES F400f: Illegal event link condition. F4010: Function not found. A4011: Not enough memory. 1) There is not enough system memory. Close the applications being executed and the open files. F4012: Timer is being disabled. W4013: Access size is different from its mapped bus size. F4014: Can not use software break. F4015: Can not use event condition specifying address range. F4016: Can not change event condition. F4017: Can not access word at odd address. A4018: Not enough memory. 1) There is not enough system memory. Close the applications being executed and the open files. F4019: This feature is not supported. F401a: No Event. F401b: Can not use tag-event. W401c: Software break can not be set on this area. F401d: Start event and end event of timer are not made to the same setup. F401e: Too many trace-events. F401f: Path count cannot be set up. F4020: Address range cannot be set up in event before execution. F4021: Event conditions number overflow. F4022: Software DMM conditions number overflow. F4023: Real-time call conditions number overflow. F4024: Software break call conditions number overflow. F4025: Illegal snap condition. F4026: Too many event conditions cannot be set as Phase1 and Phase2 of event link conditions. F4027: Software break conditions number which can be set as internal ROM was overflow. F4318: Illegal memory bank setting. (6) X5000~ A5000: Illegal device file type. A5001: Not enough memory. 1) There is not enough system memory. Close the applications being executed and the open files. A5002: Can not open device file. A5003: Reading of device file went wrong. A5004: Can not close device file. 262 User's Manual U17287EJ1V0UM APPENDIX D MESSAGES A5005: Illegal device file format. 1) Necessary files may be damaged. Reinstall the device file. A5006: Failed in initializing ICE. A5007: Device file has broken or error is in a file. F5008: Can not open device file. 1) Necessary files may be damaged. Reinstall the device file. F500a: Specified device file is illegal version. 1) Necessary files may be damaged. Reinstall the device file. W500b: Specified device file does not relocate IRAM. A500c: Failed in reading expc.ini. A500d: Not enough memory. 1) There is not enough system memory. Close the applications being executed and the open files. W500e: No tag data which it was going to refer to device file. A5300: Illegal device file type. A5301: Not enough memory. 1) There is not enough system memory. Close the applications being executed and the open files. A5302: Can not open database file. 1) Necessary files may be damaged. Reinstall the debugger and device file. A5303: Reading of database file went wrong. A5304: Can not close database file. A5305: Illegal database file format. 1) Necessary files may be damaged. Reinstall the debugger, and device file. A5306: Database information has been already initialized. A5307: Database information does not exist. F5308: Can not open specified database file. 1) Necessary files may be damaged. Reinstall the debugger. F5309: Specified database file is illegal version. 1) Necessary files may be damaged. Reinstall the debugger, and the device file. (7) X6000~ F6000: Current function does not exist. F6001: Illegal symbol name. F6002: Illegal condition. F6003: Illegal function name. F6004: Overflowed output buffer size. F6005: Illegal expression. User's Manual U17287EJ1V0UM 263 APPENDIX D MESSAGES (8) X7000~ F7000: Illegal mode. F7001: User program is running. F7002: User program has been stopped. F7003: Trace enabled. F7004: Trace memory is not set. F7005: Function return address does not exist, can not do step execution. W7010: No source information exists. W7011: Unknown result of step execution. A7012: Not enough memory. 1) There is not enough system memory. Close the applications being executed and the open files. A70fe: Bus hold error. 1) CPU is in the bus-hold status. Reset the debugger. A70ff: Can not communicate with ICE. F7801: End waiting state of step execution was canceled. F7802: End waiting state of step execution was canceled. F7f00: Aborted step execution. F7f02: Suspended step execution. A7f03: Failed in canceling RUN/STEP. F7f04: Can not execute non-mapped area. F7f05: This feature is not supported. (9) X8000~ F8000: Specified file was not found. F8001: Illegal line number. F8002: Current information is not set. F8003: Illegal address. F8004: This feature is not supported. (10) X9000~ A9000: Specified register symbol does not exist. A9001: Specified register symbol ID does not exist. F9002: Illegal value. A9003: Illegal condition. A9004: Too large register size. F9005: This feature is not supported. 264 User's Manual U17287EJ1V0UM APPENDIX D MESSAGES (11) Xa000~ Fa001: Illegal expression. Fa002: Start address is bigger than the end address. Fa003: Illegal source path. Fa004: Too long expression. Aa005: Not enough memory. 1) There is not enough system memory. Close the applications being executed and the open files. Fa006: Illegal argument. Fa007: Illegal program number. Fa008: Source path is not set. Fa009: File not found. Fa00a: Can not open file. 1) The file is damaged or does not exist. Recreate the file. Aa00b: Can not close file. Aa00c: Failed in reading file. 1) The file is damaged or does not exist. Recreate the file. Fa00d: Not source file of load module. Fa00e: Illegal line number. Fa00f: Variable does not exist. Aa010: Can not communicate with ICE. Fa011: Can not access register. Fa012: Can not access memory. Aa013: Reading of file went wrong. Fa014: It was going to open the binary file. Fa015: Can not get temporary path. 1) The disk is full. Delete or move unnecessary files and increase the available memory in the disk. Fa016: Can not create temporary file. 1) The disk is full. Delete or move unnecessary files and increase the available memory in the disk. Fa017: Can not remove temporary file. Fa020: This feature is not supported. Fa021: Symbol assigned to register cannot be specified. (12) Xb000~ Fb000: Illegal command line. Fb001: Program information does not exist in specified load module file. Fb002: File not found. User's Manual U17287EJ1V0UM 265 APPENDIX D MESSAGES Fb003: Function not found. Fb004: Selected load module different from kind (Chip) was loaded. Fb005: Symbol not found. 1) The address could not be found. Specify a location holding address information. Fb008: Illegal expression. Ab009: Not enough memory. 1) There is not enough system memory. Close the applications being executed and the open files. Fb00a: Illegal symbol in load module file. Fb00b: Current program does not exist. Fb00c: Current file does not exist. Ab00d: Current function does not exist. Ab00e: Current line does not exist. Ab00f: Tag not found. Ab010: Failed in loading symbol table. Ab011: Illegal line number. Fb012: Too large line number. Ab015: Reading of file went wrong. 1) The file is damaged or does not exist. Recreate the file. Ab016: Can not open file. 1) The file is damaged or does not exist. Recreate the file. Ab017: Failed in writing file. 1) The file is damaged or does not exist. Recreate the file. Ab019: Reading of file went wrong. Ab01a: Can not close file. Fb01b: Too long load module file name. Ab01c: Too many entries of the task kind. Fb01d: Address not found. Wb01e: No debug information (not compiled in Debug Build mode). Fb01f: Can not find structure member. Fb020: Can not find value. Fb021: No debug information exists in load module file. 1) To create a load module with appended debug information, execute build in build mode of Debug Build. Fb022: Illegal line number. Ab023: Current stack frame is not active. Ab024: Different section. Fb026: Too many array dimensions (> 4). 266 User's Manual U17287EJ1V0UM APPENDIX D MESSAGES Fb027: Found end of file. 1) The specified file may be damaged. Recreate the file. Fb028: This feature is not supported. Fb029: Illegal address. Ab02a: Can not communicate with ICE. Fb02b: Can not stack trace with current PC value. Fb02c: Too many blocks for one function. Fb02d: Illegal argument. Fb02e: The file does not exist in the SOURCE PATH. 1) On stopping the program, the source that the debugger tried to display could not be found. Check if the path connects to the source in the Debugger Option Dialog Box, or check if the source is in the same directory as the out file. Refer to the Assemble Window on which the error message is displayed, and check if the corresponding path connects. Fb02f: Information has been deleted because of optimization. Ab030: Monitor timed out. 1) Check the power of the in-circuit emulator, cable connections, and setting of the interface board and restart the debugger. Ab031: Already set in memory. Ab032: Out of scope. Ab033: LP is not stored. Fb034: Return execution from present PC position cannot be performed. Fb037: Too Many Line-Numbers Information. Fb038: Compiler version mismatch. 1) Recreate the load module with the latest compiler. Ab039: Failed in loading debug information. Ab03a: No more section information. Fb040: Specified file is not load module. 1) This is not a linker output file. Source debug cannot be executed with the load module before output from the linker. Specify the load module output from the linker. Ab041: Too many files in load module to download. Wb042: Symbol module is not initialized. Fb32e: Illegal port number. Fb32f: Illegal port name. Fb330: Illegal port position. Fb331: Illegal increment number. Fb332: Port for memory bank is not set. Fb333: Illegal bank number. User's Manual U17287EJ1V0UM 267 APPENDIX D MESSAGES Fb334: Area for memory bank is not set. Wb335: Too long symbol name. (13) Xc000~ Fc001: Can not open file. 1) The file is damaged or does not exist. Recreate the file. Ac002: Can not close file. Ac003: Reading of file went wrong. 1) The file is damaged or does not exist. Recreate the file. Ac004: Reading of file went wrong. Fc005: Illegal file type. Fc006: Kind (Chip) of load module is illegal. Fc007: Specified file is not load module. 1) This is not a linker output file. Source debug cannot be executed with the load module before output from the linker. Specify the load module output from the linker. Fc008: Specified load module file (COFF) is old version. Ac009: Not enough memory. 1) There is not enough system memory. Close the applications being executed and the open files. Fc00a: No mapped address was accessed. Fc00b: Load module is not loaded. Fc00c: Illegal argument. Fc00d: User program is running. Fc00e: User program is being traced. Fc00f: Interrupted. Ac010: Can not communicate with ICE. Fc011: Illegal load module file format. Fc012: Check sum error. Fc013: Too wide address range to upload (> 1M byte). Fc014: Failed in writing file. 1) The file is damaged or does not exist. Recreate the file. Fc015: Illegal program number. Fc016: Load information is full. Wc017: Symbol information is duplicated, please reset symbols. Fc018:Specified file is not load module. 1) This is not a linker output file. Source debug cannot be executed with the load module before output from the linker. Specify the load module output from the linker. Fc019: Failed in writing memory. 268 User's Manual U17287EJ1V0UM APPENDIX D MESSAGES Wc01a: BSS area is assigned to non-mapped area. 1) When the program is executed, a non-map break may occur. Either allocate the BSS area to the internal RAM by using a link directive, or map the emulation memory or target memory to the BSS area using the Configuration Dialog Box of the debugger. Fc01b: Programmable-IOR address not specified. 1) Necessary files may be damaged. Reinstall the debugger. Wc01c: Programmable IOR address mismatch. 1) Necessary files may be damaged. Reinstall the debugger. Wc01d: Selected load module different from kind (Chip) was loaded. Fc01e: Flash erase is not supported on IECUBE. Fc100: This feature is not supported. (14) Xd000~ Ad000: Error occurred inside debugger. Ad001: Not enough memory. 1) There is not enough system memory. Close the applications being executed and the open files. Ad002: Failed in reading initialization file (expc.ini). Ad003: ICE is not connected. Fd004: Can not find Dynamic Link Library. (15) Xe000~ Fe000: Illegal argument. Fe001: Illegal start address. Fe002: Illegal end address. Fe003: Too large size. Fe004: Can not open file. 1) The file is damaged or does not exist. Recreate the file. Fe005: Failed in reading file. 1) The file is damaged or does not exist. Recreate the file. Fe006: Reading of file went wrong. Fe007: Failed in writing file. 1) The file is damaged or does not exist. Recreate the file. Ae008: Not enough memory. 1) There is not enough system memory. Close the applications being executed and the open files. Fe009: Illegal file format. Fe00a: Verification error. User's Manual U17287EJ1V0UM 269 APPENDIX D MESSAGES Fe010: This feature is not supported. (16) Xf000~ Af000: Not enough memory. 1) There is not enough system memory. Close the applications being executed and the open files. Ff000: Not enough memory. Ff001: [XXX] not found. Wf002: Not found [XXX]. Search from the beginning? Wf003: Already exceed search region. Ff004: Missing parameter. Ff005: Illegal function name. Ff006: Illegal number. Ff007: Start address is bigger than end address. Ff008: Illegal symbol or expression. Ff009: [XXX] This file is illegal type. Ff100: Disk cannot write or full. Ff101: File not found. Ff102: File not Create. Ff103: Old project file version. Ff104: Illegal project file format. Ff105: This file is a project file for [XXX].Please select a correct file. Wf106: CPU in the Project File was Changed. You must exit the debugger for the new CPU. Do you exit the Debugger? Wf107: CPU in the Project File was Changed. Do you start the Debugger with this CPU? Wf108: Selected project file different [YYY] from chip [XXX] was opened. Does it open, although the chip cannot be changed? Wf109: Project Manager cannot be used with the debugger of this version. Please use PMplus. Wf200: No difference encountered. Ff201: Memory mapping error. Ff202: Verify error. 1) External memory could not be accessed, as it is not set. Change the register values necessary for accessing the external memory using the SFR Window or Hook Procedure before download . Wf203: When a program is running, while rewriting a memory, program execution stops for a moment. Do you wish to rewrite a memory? Wf300: Would you like to save the changes made in [XXX]? Ff301: The symbol being used on the event condition can't be evaluated. Wf302: Delete: [XXX] 270 User's Manual U17287EJ1V0UM APPENDIX D MESSAGES Wf303: [XXX] is edited. Delete: [YYY]? Wf304: [XXX] is edited. Save: [YYY]? Wf305: [XXX] is already exist. Do you replace it? Ff306: This name is too long. Ff307: There is the same name in other kinds. Ff308: An address can't be omitted. Ff309: Illegal address mask. Ff30a: Illegal data mask. Ff30b: Illegal ext probe mask. Ff30c: Illegal ext probe data. Ff30d: Illegal pass count. Ff30e: Illegal register name. Ff310: Illegal delay count. Wf311: Only one [XXX] can be enabled. Do you make this [YYY] to enable? Ff312: [XXX] is already there. Ff313: Event number already exist. Ff314: Event name is not set. Ff315: [XXX] is already there. Ff316: Max number of enabled [XXX] event is over. Please disable other enabled [YYY] event. Ff317: Max number of set event is over. Ff31e: Illegal start address. Ff31f: Illegal end address. Ff322: Illegal count rate. Ff324: Section and Qualify can be specified at the same time. Ff350: There is a phase which event are not in the middle. Ff351: The same event is contained in Link and Disable. Ff352: An event isn't specified. Ff357: AND event is in Phase. Ff500: Illegal symbol. Ff501: Illegal value. Ff502: Illegal parameter. Ff503: Max number of symbol is over. User's Manual U17287EJ1V0UM 271 APPENDIX D MESSAGES Ff504: This variable cannot be set as a break. 1) Break cannot be set for the following variables. - Local variables, static variables - Array variables, member variables of structures/unions - Register/SFR - Variable expressions Wf600: Save project file? Wf601: When connecting the target system, please turn on the target system. 1) When a target is not connected, simply click the 272 User's Manual U17287EJ1V0UM APPENDIX D MESSAGES Wfb00: User program is running. Do you want to stop user program? 1) User's Manual U17287EJ1V0UM 273 APPENDIX E INDEX APPENDIX E INDEX A About Dialog Box ... 195 Active status and static status ... 65 Add I/O Port Dialog Box ... 167 Add Watch Dialog Box ... 136 Address move Dialog Box ... 125 Assemble Search Dialog Box ... 123 Assemble Window ... 119 F Font Dialog Box ... 198 G -g option ... 20 H hook procedure ... 208 B break Breakpoint setting ... 43 setting break to variable ... 44 Break Dialog Box ... 182 break function ... 42 Browse Dialog Box ... 200 I In-circuit emulator ... 19 input conventions ... 246 Installing ... 21 IOR Select Dialog Box ... 165 IOR Window ... 161 C callback procedure ... 207 Change Watch Dialog Box ... 139 character set ... 246 clock ... 88 Come Here ... 47 command ... 197 command list ... 204 Command reference ... 202 Configuration Dialog Box ... 86 Console Window ... 197 Contents saved to project file ... 62 Context menu ... 74 J jump function ... 66 L Load/Save Function ... 61 Local Variable Window ... 141 D Debug function list ... 36 Debugger Option Dialog Box ... 95 download ... 38 Download Dialog Box ... 105 Download Function / Upload Function ... 38 drag & drop function ... 68 E Environment Setting File Load Dialog Box ... 191 Environment Setting File Save Dialog Box ... 189 Error messages at start up ... 29 Errors ... 255 Event function ... 56 Event icon ... 59 Event Setting Status (Event Mark) ... 111 Exit Debugger Dialog Box ... 194 Expressions ... 248 Extended Option Dialog Box ... 90 M Main window ... 75 Managing events ... 59 Mapping setting ... 89 Mask ... 89 Memory Compare Dialog Box ... 155 Memory Compare Result Dialog Box ... 157 Memory Copy Dialog Box ... 153 Memory Fill Dialog Box ... 151 Memory manipulation function ... 52 Memory Search Dialog Box ... 149 Memory Window ... 146 Messages ... 255 Mixed display mode Source window ... 40 O Operating Environment ... 19 Operators ... 249 P PM plus ... 30 Point mark area ... 111, 120 program code ... 112 Program execution function ... 46 project file ... 61, 194 274 User's Manual U17287EJ1V0UM APPENDIX E INDEX Project File Load Dialog Box ... 103 Project File Save Dialog Box ... 101 where ... 238 wish ... 239 Types of Messages ... 255 Q Quick Watch Dialog Box ... 133 R Range of Radixes ... 250 Real-time monitor function (RRM function) ... 60 Register Window ... 158 reset ... 193 Reset Debugger Dialog Box ... 193 right click menu ... 74 RRM Dialog Box ... 92 RRM function ... 60 U Uninstalling ... 21 Upload ... 38 Upload Dialog Box ... 108 V Verify check ... 91 view file ... 63 View File Load Dialog Box ... 187 View File Save Dialog Box ... 184 S Setting debugging environment ... 37 setting file ... 64 Software Break Manager ... 169 Source Search Dialog Box ... 115 Source Text move Dialog Box ... 117 Source Window ... 110 Stack trace display function ... 51 Stack Window ... 143 Start From Here ... 47 Startup option ... 23 Startup Routine ... 98 Status bar ... 84 Symbol To Address Dialog Box ... 126 W Watch function ... 48 Watch Window ... 128 window list ... 72 window reference ... 71 T Tcl assemble ... 211 batch ... 212 breakpoint ... 213 dbgexit ... 215 download ... 216 extwin ... 217 finish ... 218 go ... 219 help ... 220 hook ... 221 inspect ... 222 jump ... 223 map ... 224 mdi ... 225 memory ... 226 module ... 227 next ... 228 refresh ... 229 register ... 230 reset ... 231 run ... 232 step ... 233 stop ... 234 upload ... 235 version ... 236 watch ... 237 User's Manual U17287EJ1V0UM 275 |
Price & Availability of ID78K0S-QB
 |
|
|
|
|
All Rights Reserved © IC-ON-LINE 2003 - 2022 |
| [Add Bookmark] [Contact Us] [Link exchange] [Privacy policy] |
|
Mirror Sites : [www.datasheet.hk]
[www.maxim4u.com] [www.ic-on-line.cn]
[www.ic-on-line.com] [www.ic-on-line.net]
[www.alldatasheet.com.cn]
[www.gdcy.com]
[www.gdcy.net] |